Skip to main content
POST
Request data, acquiring a cache miss

Body

application/json

The same request body as /api/v1/data/query. Format does not change what is acquired.

Data meaning is independent of representation and delivery. JSON (default) and CSV are returned inline. Bbox order: west,south,east,north; no antimeridian crossing. Date bounds inclusive; at most 31 days and 10,000 cells; actual coverage must pass resolve. dataset_version pins reproducibility.

variables
enum<string>[]
required
Required array length: 1 element
Available options:
air_temperature_max,
air_temperature_min,
precipitation_amount
region
object
required
period
object
required
temporal_resolution
string
required
Allowed value: "daily"
spatial_resolution
string
required
Allowed value: "native"
units
object
required

Exactly one entry, for the requested variable.

data_class
string
required
Allowed value: "interpolated_observation"
missing_policy
string
required
Allowed value: "preserve"
format
enum<string>
default:json
Available options:
json,
csv
source_preference
enum<string>
default:auto

auto picks the finest source covering the region: SILO (Australia), NOAA nClimGrid-Daily (contiguous US), NOAA CPC (global).

Available options:
auto,
silo,
nclimgrid,
cpc
dataset_version
string

Pin an immutable published dataset version. Omit to choose a compatible public version.

Pattern: ^[a-zA-Z0-9_-]{1,128}$

Response

Cache hit: published coverage already satisfies the request (free).

status
string
required
Allowed value: "ready"
cache
string
required
Allowed value: "hit"
datasetVersion
string
required
Pattern: ^[a-zA-Z0-9_-]{1,128}$
rowCount
integer
required
Required range: x <= 9007199254740991