weather

13 endpoints at a glance

Method	Path	Summary
GET	/admin/weather/imports/	List Imports
GET	/weather/alerts/	List Alerts
GET	/weather/correlation/	Correlation Top
GET	/weather/correlation/{cc}/	Correlation Country
GET	/weather/correlation/{cc}/overlay/	Correlation Overlay
GET	/weather/correlation/cities/	Correlation Cities
GET	/weather/correlation/city/{gid}/	Correlation City
GET	/weather/correlation/city/{gid}/overlay/	Correlation City Overlay
GET	/weather/country/{cc}/series/	Country Series
GET	/weather/latest/	Latest Map
GET	/weather/point/{point_id}/series/	Point Series
GET	/weather/points/	List Points
GET	/weather/status/	Get Status

weather

---

Get Status

GET

/weather/status/

Parameters

Header Parameters

authorization

x-api-key

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/weather/status/

Playground

Headers

authorization

x-api-key

Samples

---

List Points

GET

/weather/points/

Parameters

Header Parameters

authorization

x-api-key

Query Parameters

country

limit

Type

integer

Default

5000

Responses

Successful Response

Content-Type

application/json

[

  

{

  

  

"additionalProperties": "string"

  

}

]

GET

/weather/points/

Playground

Headers

authorization

x-api-key

Variables

Key

Value

country

limit

Samples

---

Latest Map

GET

/weather/latest/

Most-recent per-country temperature rollup — drives the choropleth.

Parameters

Header Parameters

authorization

x-api-key

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/weather/latest/

Playground

Headers

authorization

x-api-key

Samples

---

Country Series

GET

/weather/country/{cc}/series/

Parameters

Header Parameters

authorization

x-api-key

Path Parameters

cc*

Type

string

Required

Query Parameters

start_ts*

Type

integer

Required

end_ts*

Type

integer

Required

Responses

Successful Response

Content-Type

application/json

[

  

{

  

  

"additionalProperties": "string"

  

}

]

GET

/weather/country/{cc}/series/

Playground

Headers

authorization

x-api-key

Variables

Key

Value

cc*

start_ts*

end_ts*

Samples

---

Point Series

GET

/weather/point/{point_id}/series/

Parameters

Header Parameters

authorization

x-api-key

Path Parameters

point_id*

Type

string

Required

Query Parameters

start_ts*

Type

integer

Required

end_ts*

Type

integer

Required

Responses

Successful Response

Content-Type

application/json

[

  

{

  

  

"additionalProperties": "string"

  

}

]

GET

/weather/point/{point_id}/series/

Playground

Headers

authorization

x-api-key

Variables

Key

Value

point_id*

start_ts*

end_ts*

Samples

---

Correlation Top

GET

/weather/correlation/

Per-country temperature↔outage correlation, ranked by extreme-heat lift
(by=lift_p90) or absolute correlation (by=abs_r).

Parameters

Header Parameters

authorization

x-api-key

Query Parameters

by

Type

string

Default

"lift_p90"

limit

Type

integer

Default

50

Responses

Successful Response

Content-Type

application/json

[

  

{

  

  

"additionalProperties": "string"

  

}

]

GET

/weather/correlation/

Playground

Headers

authorization

x-api-key

Variables

Key

Value

by

limit

Samples

---

Correlation Cities

GET

/weather/correlation/cities/

Per-city temperature↔outage correlation (finer than country), ranked by
extreme-heat lift or absolute correlation.

Parameters

Header Parameters

authorization

x-api-key

Query Parameters

by

Type

string

Default

"lift_p90"

limit

Type

integer

Default

100

Responses

Successful Response

Content-Type

application/json

[

  

{

  

  

"additionalProperties": "string"

  

}

]

GET

/weather/correlation/cities/

Playground

Headers

authorization

x-api-key

Variables

Key

Value

by

limit

Samples

---

Correlation City

GET

/weather/correlation/city/{gid}/

Parameters

Header Parameters

authorization

x-api-key

Path Parameters

gid*

Type

integer

Required

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/weather/correlation/city/{gid}/

Playground

Headers

authorization

x-api-key

Variables

Key

Value

gid*

Samples

---

Correlation City Overlay

GET

/weather/correlation/city/{gid}/overlay/

Per-hour {t2m_mean, disconnects} for one city's dual-axis chart.

Parameters

Header Parameters

authorization

x-api-key

Path Parameters

gid*

Type

integer

Required

Query Parameters

start_ts*

Type

integer

Required

end_ts*

Type

integer

Required

Responses

Successful Response

Content-Type

application/json

[

  

{

  

  

"additionalProperties": "string"

  

}

]

GET

/weather/correlation/city/{gid}/overlay/

Playground

Headers

authorization

x-api-key

Variables

Key

Value

gid*

start_ts*

end_ts*

Samples

---

Correlation Country

GET

/weather/correlation/{cc}/

Parameters

Header Parameters

authorization

x-api-key

Path Parameters

cc*

Type

string

Required

Responses

Successful Response

Content-Type

application/json

{

  

"additionalProperties": "string"

}

GET

/weather/correlation/{cc}/

Playground

Headers

authorization

x-api-key

Variables

Key

Value

cc*

Samples

---

Correlation Overlay

GET

/weather/correlation/{cc}/overlay/

Per-hour {t2m_mean, disconnects} for the dual-axis temp-vs-outage
chart.

Parameters

Header Parameters

authorization

x-api-key

Path Parameters

cc*

Type

string

Required

Query Parameters

start_ts*

Type

integer

Required

end_ts*

Type

integer

Required

Responses

Successful Response

Content-Type

application/json

[

  

{

  

  

"additionalProperties": "string"

  

}

]

GET

/weather/correlation/{cc}/overlay/

Playground

Headers

authorization

x-api-key

Variables

Key

Value

cc*

start_ts*

end_ts*

Samples

---

List Alerts

GET

/weather/alerts/

Places where extreme weather currently coincides with elevated probe
disconnects. scope=country | city filters the granularity (both when
omitted); only_open=false includes recently-closed episodes.

Parameters

Header Parameters

authorization

x-api-key

Query Parameters

only_open

Type

boolean

Default

true

scope

limit

Type

integer

Default

100

Responses

Successful Response

Content-Type

application/json

[

  

{

  

  

"additionalProperties": "string"

  

}

]

GET

/weather/alerts/

Playground

Headers

authorization

x-api-key

Variables

Key

Value

only_open

scope

limit

Samples

---

List Imports

GET

/admin/weather/imports/

Parameters

Header Parameters

authorization

x-api-key

Query Parameters

limit

Type

integer

Default

50

Responses

Successful Response

Content-Type

application/json

[

  

{

  

  

"additionalProperties": "string"

  

}

]

GET

/admin/weather/imports/

Playground

Headers

authorization

x-api-key

Variables

Key

Value

limit

Samples

---