API Documentation

Overview

The HICS API is public and authentication-free. No API key required. Rate limit: 120 requests/minute. All responses are JSON. Timestamps are UTC ISO 8601.

Base URL: https://himalayansciences.org/api/

Endpoints

GET /api/v1/stations/

List all active and maintenance stations with status and latest reading summary.

Example

curl https://himalayansciences.org/api/v1/stations/

Response fields

Field	Type	Description
station_id	string	Unique station identifier
name	string	Human-readable station name
latitude / longitude	float	Decimal degrees
altitude_m	float	Metres above sea level
status	string	active / maintenance
last_seen	datetime	Last telemetry timestamp (UTC)
latest.temperature_c	float	Most recent temperature (°C)

GET /api/v1/data/latest/?station=KTM-001

The single most-recent reading for a station, including all sensor values and the auto-assigned quality flag.

Example

curl "https://himalayansciences.org/api/v1/data/latest/?station=KTM-001"

Additional response fields

quality_flag — ok | suspect | invalid. Automatically assigned on ingestion. suspect = value outside physical plausibility bounds. invalid = manually flagged by an operator.

GET /api/v1/data/historical/?station=KTM-001&hours=24

Time series for the requested station. Returns an array of readings ordered by timestamp ascending. Maximum window: 720 hours (30 days).

curl "https://himalayansciences.org/api/v1/data/historical/?station=KTM-001&hours=168"

Parameters

Param	Default	Description
station	KTM-001	Station ID
hours	24	Lookback window in hours. Clamped to [1, 720].

GET /api/v1/data/download/?station=KTM-001

Full station history as a streaming CSV download. Includes attribution comment header with CC BY 4.0 licence and citation template. File size grows with data volume; use the historical endpoint for smaller queries.

curl -OJ "https://himalayansciences.org/api/v1/data/download/?station=KTM-001"

CSV columns

timestamp_utc, temperature_c, humidity_rh, pressure_hpa, pm2_5_ugm3, pm10_ugm3, co2_ppm, quality_flag

GET /api/v1/health/

Station health check endpoint. Returns ok: true plus station status and most-recent-reading age for each station. Suitable for uptime monitors.

curl https://himalayansciences.org/api/v1/health/

Data Quality Flags

Every reading carries a quality_flag field assigned automatically at ingestion time.

Flag	Meaning
ok	All values within physical plausibility bounds.
suspect	One or more values outside physical bounds. Bounds: temp −50..60°C, RH 0..100%, pressure 300..1100 hPa, PM2.5 0..1000 µg/m³.
invalid	Manually flagged as invalid by a station operator. Exclude from analysis.

Station IDs

DLP-001 · Active

CMS Thermal Monitor

Dho Tarap, Dolpo · 4000m

KTM-001 · Active

Kathmandu Central Station

Kathmandu · 1350m