Get a list of measurements

GET

/v1/measurements

Parameters

Query Parameters

format

Any of:

string

string

null

null

date_from

Any of:

string

string format: date-time

string

string format: date

string

string

integer

integer

null

null

From when?

date_to

Any of:

string

string format: date-time

string

string format: date

string

string

integer

integer

null

null

To when?

limit

Any of:

integer

integer

null

null

Change the number of results returned. e.g. limit=1000 will return up to 1000 results

page

Any of:

integer

integer

null

null

Paginate through results. e.g. page=1 will return first page of results

offset

Any of:

integer

integer

null

null

sort

string

Allowed values: asc desc

has_geo

Any of:

boolean

boolean

null

null

parameter_id

Any of:

integer

integer

null

null

(optional) A parameter ID to filter measurement results. e.g. parameter_id=2 (i.e. PM2.5) will limit measurement results to only PM2.5 measurements

parameter

Any of:

Array<string>

Array<string>

null

null

(optional) A parameter name or ID by which to filter measurement results. e.g. parameter=pm25 or parameter=pm25&parameter=pm10

unit

Any of:

Array<string>

Array<string>

null

null

coordinates

Any of:

string

string

null

null

Coordinate pair in form lat,lng. Up to 8 decimal points of precision e.g. 38.907,-77.037

radius

Search radius from coordinates as center in meters. Maximum of 25,000 (25km) defaults to 1000 (1km) e.g. radius=10000

integer

default: 1000

Search radius from coordinates as center in meters. Maximum of 25,000 (25km) defaults to 1000 (1km) e.g. radius=10000

country_id

Any of:

integer

integer

null

null

Limit results by a certain country using two digit country ID. e.g. 13

country

Any of:

Array<string>

Array<string>

null

null

Limit results by a certain country using two letter country code. e.g. ?country=US or ?country=US&country=MX

city

Any of:

Array<string>

Array<string>

null

null

Limit results by a certain city or cities. (e.g. ?city=Chicago or ?city=Chicago&city=Boston)

location_id

Any of:

Array<integer>

Array<integer>

null

null

location

Any of:

Array<string>

Array<string>

null

null

order_by

string

Allowed values: city country location datetime

is_mobile

Any of:

boolean

boolean

null

null

Location is mobile e.g. ?isMobile=true

is_analysis

Any of:

boolean

boolean

null

null

Data is the product of a previous analysis/aggregation and not raw measurements e.g. ?isAnalysis=false

project

Any of:

integer

integer

null

null

entity

Any of:

EntityTypes

string

Allowed values: government community research

null

null

sensor_type

Any of:

SensorTypes

string

Allowed values: reference grade low-cost sensor

null

null

Filter by sensor type (i,e. reference grade, low-cost sensor) e.g. ?sensorType=reference%20grade

value_from

Any of:

number

number

null

null

value_to

Any of:

number

number

null

null

include_fields

Any of:

string

string

null

null

Additional fields to include in response e.g. ?include_fields=sourceName

Responses

200

Successful Response

object

meta

object

name

string

default: openaq-api

license

string

""

website

string

default: /

page

integer

default: 1

limit

integer

default: 100

found

Any of:

integer

integer

string

string

null

null

results

required

Array<object>

object

location

required

string

parameter

required

string

value

required

number

date

required

object

utc

required

string

local

required

string

unit

required

string

coordinates

required

object

latitude

Any of:

number

number

null

null

longitude

Any of:

number

number

null

null

country

Any of:

string

string

null

null

city

Any of:

string

string

null

null

422

Validation Error

object

detail

Array<object>

object

loc

required

Array

msg

required

string

type

required

string