API documentation

This is not a stable API, please check in periodically to make sure your queries are up to date.

Every response is returned in JSON format.

List of Sessions
Mobile Session with Stream and Measurements
Measurements
- Mobile Measurements
- Fixed Measurements
All session streams
Averages
Region
Last Session
Sessions for given time range and sensor package name
Parameters description
FAQ
- How to encode URLs

List of Sessions

Endpoints that return a list of sessions and their streams (without measurements).

Mobile

Endpoint

GET /api/mobile/sessions.json

Parameters

name	type	required
q[time_from]	number	yes
q[time_to]	number	yes
q[tags]	text	yes
q[usernames]	text	yes
q[west]	number, -180..180	yes
q[east]	number, -180..180	yes
q[south]	number, -90..90	yes
q[north]	number, -90..90	yes
q[limit]	number	yes
q[offset]	number	yes
q[sensor_name]	text	yes
q[measurement_type]	text	yes
q[unit_symbol]	text	yes

See parameters description

Example

request

https://aircasting.org/api/mobile/sessions.json?q={"time_from":1533081600,"time_to":1535759940,"tags":"","usernames":"HabitatMap","west":-74.00000000,"east":-73.00000000,"south":40.00000000,"north":41.00000000,"limit":1,"offset":0,"sensor_name":"airbeam2-pm2.5","measurement_type":"Particulate Matter","unit_symbol":"µg/m³"}

encoded request

curl https://aircasting.org/api/mobile/sessions.json?q=%7B%22time_from%22%3A1533081600%2C%22time_to%22%3A1535759940%2C%22tags%22%3A%22%22%2C%22usernames%22%3A%22HabitatMap%22%2C%22west%22%3A-74.00000000%2C%22east%22%3A-73.00000000%2C%22south%22%3A40.00000000%2C%22north%22%3A41.00000000%2C%22limit%22%3A1%2C%22offset%22%3A0%2C%22sensor_name%22%3A%22airbeam2-pm2.5%22%2C%22measurement_type%22%3A%22Particulate%20Matter%22%2C%22unit_symbol%22%3A%22%C2%B5g%2Fm%C2%B3%22%7D

See how to encode URLs

response

{
  "sessions": [
    {
      "id": 64047,
      "title": "soho to Park slope",
      "start_time_local": "2018-08-28T14:08:47.000Z",
      "end_time_local": "2018-08-28T14:34:06.000Z",
      "type": "MobileSession",
      "username": "HabitatMap",
      "streams": {
        "AirBeam2-PM2.5": {
          "average_value": 21.2783,
          "id": 219614,
          "max_latitude": 40.72111137,
          "max_longitude": -73.97625898,
          "measurement_short_type": "PM",
          "measurement_type": "Particulate Matter",
          "measurements_count": 1520,
          "min_latitude": 40.68043272,
          "min_longitude": -73.99912318,
          "sensor_name": "AirBeam2-PM2.5",
          "sensor_package_name": "AirBeam2:00189610719F",
          "session_id": 64047,
          "size": 1520,
          "start_latitude": 40.72107652,
          "start_longitude": -73.99801224,
          "threshold_high": 55,
          "threshold_low": 12,
          "threshold_medium": 35,
          "threshold_very_high": 150,
          "threshold_very_low": 0,
          "unit_name": "micrograms per cubic meter",
          "unit_symbol": "µg/m³"
        }
      }
    }
  ],
  "fetchableSessionsCount": 2
}

Fixed Active

Active sessions recorded data in the last 24h.

Endpoint

GET /api/fixed/active/sessions.json

Parameters

name	type	required	default behaviour
q[time_from]	number	yes	N/A
q[time_to]	number	yes	N/A
q[sensor_name]	text	yes	N/A
q[unit_symbol]	text	yes	N/A
q[tags]	text	yes	N/A
q[usernames]	text	yes	N/A
q[measurement_type]	text	yes	N/A
q[is_indoor]	bool	no	returns sessions of any placement
q[west]	number, -180..180	no	returns sessions from all location unless all 4 coordinates are provided
q[east]	number, -180..180	no	returns sessions from all location unless all 4 coordinates are provided
q[south]	number, -90..90	no	returns sessions from all location unless all 4 coordinates are provided
q[north]	number, -90..90	no	returns sessions from all location unless all 4 coordinates are provided

See parameters description

Example

request

https://aircasting.org/api/fixed/active/sessions.json?q={"time_from":"1531008000","time_to":"1562630399","tags":"","usernames":"","west":-73.9766655034307,"east":-73.97618605856928,"south":40.68019783151002,"north":40.680367168382396,"sensor_name":"airbeam2-pm2.5","measurement_type":"Particulate Matter","unit_symbol":"µg/m³"}

encoded request

curl https://aircasting.org/api/fixed/active/sessions.json?q=%7B%22time_from%22%3A%221531008000%22%2C%22time_to%22%3A%221562630399%22%2C%22tags%22%3A%22%22%2C%22usernames%22%3A%22%22%2C%22west%22%3A-73.9766655034307%2C%22east%22%3A-73.97618605856928%2C%22south%22%3A40.68019783151002%2C%22north%22%3A40.680367168382396%2C%22sensor_name%22%3A%22airbeam2-pm2.5%22%2C%22measurement_type%22%3A%22Particulate%20Matter%22%2C%22unit_symbol%22%3A%22%C2%B5g%2Fm%C2%B3%22%7D

See how to encode URLs

response

{
  "sessions": [
    {
      "id": 73984,
      "title": "HabitatMap HQ - Cellular",
      "start_time_local": "2018-12-04T11:23:51.000Z",
      "end_time_local": "2019-07-08T07:18:15.000Z",
      "last_hour_average": 5.32786885245902,
      "is_indoor": false,
      "latitude": 40.6802825,
      "longitude": -73.976425781,
      "type": "FixedSession",
      "username": "HabitatMap",
      "streams": {
        "AirBeam2-PM2.5": {
          "average_value": null,
          "id": 257428,
          "max_latitude": 40.6802825,
          "max_longitude": -73.976425781,
          "measurement_short_type": "PM",
          "measurements_count": 300222,
          "min_latitude": 40.6802825,
          "min_longitude": -73.976425781,
          "sensor_name": "AirBeam2-PM2.5",
          "sensor_package_name": "Airbeam2-001896038A92",
          "session_id": 73984,
          "size": 300222,
          "start_latitude": 40.6802825,
          "start_longitude": -73.976425781,
          "threshold_high": 55,
          "threshold_low": 12,
          "threshold_medium": 35,
          "threshold_very_high": 150,
          "threshold_very_low": 0,
          "unit_name": "microgram per cubic meter",
          "unit_symbol": "µg/m³"
        }
      }
    }
  ],
  "fetchableSessionsCount": 1
}

Endpoint

GET /api/fixed/active/sessions2.json

Parameters

name	type	required	default behaviour
q[time_from]	number	yes	N/A
q[time_to]	number	yes	N/A
q[sensor_name]	text	yes	N/A
q[unit_symbol]	text	yes	N/A
q[tags]	text	yes	N/A
q[usernames]	text	yes	N/A
q[measurement_type]	text	yes	N/A
q[is_indoor]	bool	no	returns sessions of any placement
q[west]	number, -180..180	no	returns sessions from all location unless all 4 coordinates are provided
q[east]	number, -180..180	no	returns sessions from all location unless all 4 coordinates are provided
q[south]	number, -90..90	no	returns sessions from all location unless all 4 coordinates are provided
q[north]	number, -90..90	no	returns sessions from all location unless all 4 coordinates are provided

See parameters description

Example

request

https://aircasting.org/api/fixed/active/sessions2.json?q={"time_from":"1531008000","time_to":"1562630399","tags":"","usernames":"","west":-73.9766655034307,"east":-73.97618605856928,"south":40.68019783151002,"north":40.680367168382396,"sensor_name":"airbeam2-pm2.5","measurement_type":"Particulate Matter","unit_symbol":"µg/m³"}

encoded request

curl https://aircasting.org/api/fixed/active/sessions.json?q=%7B%22time_from%22%3A%221531008000%22%2C%22time_to%22%3A%221562630399%22%2C%22tags%22%3A%22%22%2C%22usernames%22%3A%22%22%2C%22west%22%3A-73.9766655034307%2C%22east%22%3A-73.97618605856928%2C%22south%22%3A40.68019783151002%2C%22north%22%3A40.680367168382396%2C%22sensor_name%22%3A%22airbeam2-pm2.5%22%2C%22measurement_type%22%3A%22Particulate%20Matter%22%2C%22unit_symbol%22%3A%22%C2%B5g%2Fm%C2%B3%22%7D

See how to encode URLs

response

{
  "sessions": [
    {
      "id": 73984,
      "title": "HabitatMap HQ - Cellular",
      "start_time_local": "2018-12-04T11:23:51.000Z",
      "end_time_local": "2019-07-08T07:18:15.000Z",
      "last_measurement_value": 5.32786885245902,
      "is_indoor": false,
      "latitude": 40.6802825,
      "longitude": -73.976425781,
      "username": "HabitatMap",
      "streams": {
        "AirBeam2-PM2.5": {
          "measurement_short_type": "PM",
          "sensor_name": "AirBeam2-PM2.5",
          "unit_symbol": "µg/m³",
          "id": 123
        }
      }
    }
  ],
  "fetchableSessionsCount": 1
}

Fixed Dormant

Endpoint

GET /api/fixed/dormant/sessions.json

Parameters

name	type	required	default behaviour
q[time_from]	number	yes	N/A
q[time_to]	number	yes	N/A
q[sensor_name]	text	yes	N/A
q[measurement_type]	text	yes	N/A
q[unit_symbol]	text	yes	N/A
q[tags]	text	yes	N/A
q[usernames]	text	yes	N/A
q[is_indoor]	bool	no	returns sessions of any placement
q[west]	number, -180..180	no	returns sessions from all location unless all 4 coordinates are provided
q[east]	number, -180..180	no	returns sessions from all location unless all 4 coordinates are provided
q[south]	number, -90..90	no	returns sessions from all location unless all 4 coordinates are provided
q[north]	number, -90..90	no	returns sessions from all location unless all 4 coordinates are provided
q[limit]	number	no	returns all sessions
q[offset]	number	no	starts at the beginning

See parameters description

Example

request

https://aircasting.org/api/fixed/dormant/sessions.json?q={"time_from":1543622400,"time_to":1546300740,"tags":"","usernames":"HabitatMap","sensor_name":"airbeam2-pm2.5","measurement_type":"Particulate Matter","unit_symbol":"µg/m³"}

encoded request

curl https://aircasting.org/api/fixed/dormant/sessions.json?q=%7B%22time_from%22%3A1543622400%2C%22time_to%22%3A1546300740%2C%22tags%22%3A%22%22%2C%22usernames%22%3A%22HabitatMap%22%2C%22sensor_name%22%3A%22airbeam2-pm2.5%22%2C%22measurement_type%22%3A%22Particulate%20Matter%22%2C%22unit_symbol%22%3A%22%C2%B5g%2Fm%C2%B3%22%7D

See how to encode URLs

response

{
  "sessions": [
    {
      "id": 49869,
      "title": "HabitatMap HQ - Cellular",
      "start_time_local": "2018-03-23T16:22:07.000Z",
      "end_time_local": "2018-12-04T11:07:03.000Z",
      "is_indoor": false,
      "latitude": 40.6802725,
      "longitude": -73.976386719,
      "type": "FixedSession",
      "username": "HabitatMap",
      "streams": {
        "AirBeam2-PM2.5": {
          "average_value": null,
          "id": 170225,
          "max_latitude": 40.6802725,
          "max_longitude": 40.6802725,
          "measurement_short_type": "PM",
          "measurement_type": "Particulate Matter",
          "measurements_count": 341894,
          "min_latitude": -73.976386719,
          "min_longitude": -73.976386719,
          "sensor_name": "AirBeam2-PM2.5",
          "sensor_package_name": "Airbeam2-001896038A92",
          "session_id": 49869,
          "size": 341894,
          "start_latitude": 40.6802725,
          "start_longitude": -73.976386719,
          "threshold_high": 55,
          "threshold_low": 12,
          "threshold_medium": 35,
          "threshold_very_high": 150,
          "threshold_very_low": 0,
          "unit_name": "microgram per cubic meter",
          "unit_symbol": "µg/m³"
        }
      }
    }
  ],
  "fetchableSessionsCount": 1
}

Filtered list of sessions

Endpoint

GET /api/v3/sessions

Fetches sessions (with their streams) within a time window.

Parameters

Name	Type	Required	Format / Expectations	Notes
`tags[]`	string	no	Repeated, bracketed keys in the query: `tags[]=river&tags[]=morning`	Match sessions that have any of the provided tags (logical OR within `tags[]`).
`sensor_package_name`	string	no		Example: `AirBeam:123Abc` (URL-encode `:` as `%3A` in URLs).
`start_datetime`	string (datetime)	no	ISO-8601 recommended, e.g. `2025-01-15T00:00:00Z`	Reference: session local start time.
`end_datetime`	string (datetime)	no	ISO-8601 recommended, e.g. `2025-01-16T00:00:00Z`	Reference: session local start time.

Defaults & filtering

Time window default: If no date params are provided, the window is last 30 days (based on session local start time).
If both start_datetime and end_datetime are provided, that window is used.
tags[] uses OR logic (a session matches if it has any of the given tags).
When both tags[] and sensor_package_name are provided, filters are combined with AND.

Example response

{
  "sessions": [
    {
      "id": 3508,
      "title": "testing tags",
      "start_datetime": "2025-09-25T12:10:29",
      "end_datetime": "2025-09-25T12:10:46",
      "type": "MobileSession",
      "streams": [
        {
          "id": 4133,
          "sensor_name": "Phone Microphone",
          "measurement_type": "Sound Level"
        }
      ]
    },
    {
      "id": 3507,
      "title": "tags test",
      "start_datetime": "2025-09-25T12:06:46",
      "end_datetime": "2025-09-25T12:06:58",
      "type": "MobileSession",
      "streams": [
        {
          "id": 4132,
          "sensor_name": "Phone Microphone",
          "measurement_type": "Sound Level"
        }
      ]
    }
  ]
}

Examples

No filters (uses default last 30 days): https://aircasting.org/api/v3/sessions
Filter by tags (OR): https://aircasting.org/api/v3/sessions?tags[]=river&tags[]=morning
Filter by sensor package name: https://aircasting.org/api/v3/sessions?sensor_package_name=AirBeam%3A123Abc
Tags + sensor package + explicit date window: https://aircasting.org/api/v3/sessions?tags[]=river&tags[]=morning&sensor_package_name=AirBeam%3A123Abc&start_datetime=2025-01-15T00:00:00Z&end_datetime=2025-01-16T00:00:00Z

Mobile Session with Stream and Measurements

Endpoint that returns a mobile session with selected stream and all its measurements.

Endpoint

GET /api/mobile/sessions2/:id

Parameters

name	type	required
q[sensor_name]	text	yes

Example

request

curl https://aircasting.org/api/mobile/sessions2/94192.json?sensor_name=AirBeam2-PM2.5

response

{
  "title": "North slope",
  "average": 5.86653771760155,
  "id": 94192,
  "contribute": true,
  "created_at": "2019-06-27T17:56:53.000Z",
  "data_type": null,
  "end_time": "2019-06-27T13:56:48.000Z",
  "end_time_local": "2019-06-27T13:56:48.000Z",
  "instrument": null,
  "is_indoor": false,
  "last_measurement_at": null,
  "latitude": 0.0,
  "longitude": 0.0,
  "measurements_count": null,
  "start_time": "2019-06-27T13:48:11.000Z",
  "start_time_local": "2019-06-27T13:48:11.000Z",
  "type": "MobileSession",
  "updated_at": "2019-07-01T16:04:59.000Z",
  "url_token": "1rpdv",
  "user_id": 2,
  "uuid": "89a83844-6a07-483d-8b4b-9c0903eeef2b",
  "notes": [],
  "streams": {
    "AirBeam2-PM2.5": {
      "average_value": 5.86654,
      "id": 329904,
      "max_latitude": 40.6804351,
      "max_longitude": -73.9722257,
      "measurement_short_type": "PM",
      "measurement_type": "Particulate Matter",
      "measurements_count": 517,
      "min_latitude": 40.6769462,
      "min_longitude": -73.9763078,
      "sensor_name": "AirBeam2-PM2.5",
      "sensor_package_name": "AirBeam2:00189610719F",
      "session_id": 94192,
      "size": 517,
      "start_latitude": 40.6769462,
      "start_longitude": -73.9722298,
      "threshold_high": 55,
      "threshold_low": 12,
      "threshold_medium": 35,
      "threshold_very_high": 150,
      "threshold_very_low": 0,
      "unit_name": "micrograms per cubic meter",
      "unit_symbol": "µg/m³",
      "measurements": [
        {
          "value": 7.0,
          "latitude": 40.6769462,
          "longitude": -73.9722298,
          "time": "2019-06-27T13:48:12.000Z"
        }
      ]
    }
  }
}

Measurements

Mobile Measurements

Returns mobile measurements for a given stream id.

Endpoint

GET /api/measurements.json

Parameters

name	type	required	default value
stream_ids	number	yes	N/A
start_time	number	no	0
end_time	number	no	current time

Example

request

curl https://aircasting.org/api/measurements.json/?end_time=2281550369000&start_time=0&stream_ids=1

response

[
  {
    "time": "2011-12-16T22:23:02Z",
    "value": 58.2103,
    "latitude": 50.05822535,
    "longitude": 19.926092562
  },
  {
    "time": "2011-12-16T22:23:03Z",
    "value": 58.977,
    "latitude": 50.05822535,
    "longitude": 19.926092562
  }
]

Fixed Measurements

Returns fixed measurements for a given stream id.

Endpoint

GET /api/v3/fixed_measurements

Parameters

name	type	required	notes
stream_id	number	yes
start_time	number	yes	epoch timestamp in milliseconds
end_time	number	yes	epoch timestamp in milliseconds

Example

request

curl https://aircasting.org/api/v3/fixed_measurements/?stream_id=2681209&start_time=1759063166000&end_time=1759149566000

response

[
  {
    "time":1759063177000,
    "value":8.0
  },
  {
    "time":1759063417000,
    "value":9.0
  },
  {
    "time":1759063357000,
    "value":9.0
  }
]

All session streams

Endpoint

GET /api/fixed/sessions/{sessionID}/streams.json

ex. {sessionID} --> 1758913 To get the measurements from all streams of the given session. It will be using sessionID.

Parameters

name	type	required	default value
measurements_limit	number	no	N/A

Example

request

 https://aircasting.org/api/fixed/sessions/1758913/streams.json?measurements_limit=14

response

{
  "id": 1758913,
  "start_time": 1649068083000,
  "end_time": 1650884234000,
  "title": "HabitatMap HQ",
  "username": "HabitatMap",
  "latitude": 40.680268333,
  "longitude": -73.976356946,
  "is_indoor": false,
  "notes": [],
  "streams": [
    {
      "sensor_name": "AirBeam3-PM2.5",
      "stream_id": 2207995,
      "sensor_unit": "µg/m³",
      "max_latitude": 40.680268333,
      "max_longitude": -73.976356946,
      "min_latitude": 40.680268333,
      "min_longitude": -73.976356946,
      "last_measurement_value": 0.0,
      "threshold_very_high": 100,
      "threshold_high": 80,
      "threshold_medium": 60,
      "threshold_low": 40,
      "threshold_very_low": 20,
      "unit_name": "µg/m³",
      "measurement_short_type": "PM",
      "measurement_type": "Particulate Matter",
      "measurements": [
        {
          "value": 0.0,
          "time": 1650884234000,
          "longitude": -73.976356946,
          "latitude": 40.680268333
        }
      ]
    }
  ]
}

Averages

Endpoint

GET /api/averages2

To get multiple average values for polygons in a region. You need to pass a list of stream ids otherwise nothing will be returned.

Parameters

name	type	default value
time_from	number
time_to	number
grid_size_y	number, 1..50
grid_size_x	number, 1..50
tags	text
usernames	text
sensor_name	text
unit_symbol	text
east	number, -180..180
west	number, -180..180
north	number, -90..90
south	number, -90..90
measurement_type	text
stream_ids	list number	empty list

See parameters description

Example

request

 https://aircasting.org/api/averages2.json?q={"west": -73.97324680251035,"east": -73.94784091872128,"south": 40.732061458135334,"north": 40.7458484802088,"time_from": "1681516800","time_to": "1713225599","grid_size_x": 44.76737160120846,"grid_size_y": 31,"tags": "","usernames": "","sensor_name": "airbeam-pm2.5","measurement_type": "Particulate Matter","unit_symbol": "µg/m³","stream_ids": [2527698, 2521559, 2521554, 2483617, 2483606, 2465507, 2437391, 2433850]}

encoded request

curl  https://aircasting.org/api/averages2.json?q=%7B%22west%22%3A-73.97324680251035%2C%22east%22%3A-73.94784091872128%2C%22south%22%3A40.732061458135334%2C%22north%22%3A40.7458484802088%2C%22time_from%22%3A%221681516800%22%2C%22time_to%22%3A%221713225599%22%2C%22grid_size_x%22%3A44.76737160120846%2C%22grid_size_y%22%3A31%2C%22tags%22%3A%22%22%2C%22usernames%22%3A%22%22%2C%22sensor_name%22%3A%22airbeam-pm2.5%22%2C%22measurement_type%22%3A%22Particulate%20Matter%22%2C%22unit_symbol%22%3A%22%C2%B5g%2Fm%C2%B3%22%2C%22stream_ids%22%3A%5B2527698%2C2521559%2C2521554%2C2483617%2C2483606%2C2465507%2C2437391%2C2433850%5D%7D

response

[
  {
    "value": 5.91492021801733,
    "west": -105.26734642360522,
    "east": -105.24249284163766,
    "south": 39.95864065006056,
    "north": 39.97751131860841
  },
  {
    "value": 14.44272413621971,
    "west": -105.26734642360522,
    "east": -105.24249284163766,
    "south": 39.9775113186084,
    "north": 39.99638198715625
  }
]

Region

This will let you fetch the average measured value for a region of the map specified by the east, west, north and south parameters. Also pass the measurement_type and sensor_name parameters to specify the measurements you want the average of. You need to pass a list of stream ids otherwise nothing will be returned.

Endpoint

GET /api/region

Parameters

name	type	default value
time_from	number
time_to	number
grid_size_y	number, 1..50
grid_size_x	number, 1..50
tags	text
usernames	text
sensor_name	text
unit_symbol	text
east	number, -180..180
west	number, -180..180
north	number, -90..90
south	number, -90..90
measurement_type	text
stream_ids	list number	empty list

See parameters description

Example

request

https://aircasting.org/api/region.json?west=-79.17133878069846&east=-79.17130272327499&south=35.472902640118186&north=35.47293458811813&time_from=1706832000&time_to=1715039940&grid_size_x=44.7361530715005&grid_size_y=31&tags=&usernames=&sensor_name=airbeam-pm2.5&measurement_type=Particulate%20Matter&unit_symbol=%C2%B5g%2Fm%C2%B3&stream_ids=2598790

response

{
  "average": 22.83333333333333,
  "number_of_contributors": 1,
  "number_of_samples": 6
}

Last Session

Endpoint

GET /api/v2/data/sessions/last

Example

request

curl https://aircasting.org/api/v2/data/sessions/last.json

response
```
{ "id": 10105 }
```

Sessions for given time range and sensor package name

Endpoint

GET /api/v3/sessions

Parameters

name	type	required	additional info
sensor_package_name	string	yes
start_datetime	datetime (YYYY-MM-DDTHH:mm:ss)	yes	used to filter sessions start time
end_datetime	datetime (YYYY-MM-DDTHH:mm:ss)	yes	used to filter sessions start time

Example

request

curl https://aircasting.org/api/v3/sessions?sensor_package_name=sensor_package_name=AirBeam:001896108717&start_datetime=2025-04-08T12:00:00&end_datetime=2025-04-10T12:00:00

response

{
  "sessions": [
      {
          "id": 1918068,
          "title": "longfellow5",
          "start_datetime": "2025-04-08T16:51:39",
          "end_datetime": "2025-04-08T17:58:45",
          "type": "MobileSession",
          "streams": [
              {
                  "id": 2760409,
                  "sensor_name": "AirBeam-F",
                  "measurement_type": "Temperature"
              },
              {
                  "id": 2760407,
                  "sensor_name": "AirBeam-RH",
                  "measurement_type": "Humidity"
              },
              {
                  "id": 2760408,
                  "sensor_name": "AirBeam-PM",
                  "measurement_type": "Particulate Matter"
              }
          ]
      },
      {
          "id": 1918198,
          "title": "longfellow6",
          "start_datetime": "2025-04-09T17:21:18",
          "end_datetime": "2025-04-09T18:28:27",
          "type": "MobileSession",
          "streams": [
              {
                  "id": 2760948,
                  "sensor_name": "AirBeam-RH",
                  "measurement_type": "Humidity"
              },
              {
                  "id": 2760949,
                  "sensor_name": "AirBeam-PM",
                  "measurement_type": "Particulate Matter"
              },
              {
                  "id": 2760950,
                  "sensor_name": "AirBeam-F",
                  "measurement_type": "Temperature"
              }
          ]
      }
  ]
}

Parameters description

Notice: your query will not return any results unless you provide all required parameters.

west, east, south, north

All four have to be provided. If one is missing results will not be filtered by location.
limit, offset

Limit indicates the number of results to fetch. Offset is useful if you want to fetch data in batches. For example one can set limit to 50 and offset to 0 to fetch the first batch. Then set limit to 50 and offset to 50 to get the next batch.
time_from, time_to
- time_from and time_to should be passed as seconds since epoch.
- They should be expressed in UTC.
- Date and time of the day are separate filters. This means that selecting q[time_from]=1559372400 and q[time_to]=1559559600 which corresponds to June 1, 2019 7 AM - June 3, 2019 11 AM will return sessions that were recording in the morning during these 3 days.
- To see all session from that period use June 1, 2019 12:00:00 AM - June 3, 2019 11:59:59 PM.
- Every session that has at least one measurement in the selected time range will be included in the results.
sensor_name, measurement_type, unit_symbol

All three are considered together. This means that only result that match all of them will be returned.

FAQ

How to encode URLs

You can use an online URL encoder to transform the JSON part. For example to encode

http://example.com?q={"name":"value"}

encode the JSON part:

'{"name":"value"}' => %7B%22name%22%3A%22value%22%7D

then you can use the URL with curl command:

curl http://example.com\?q\=%7B%22name%22%3A%22value%22%7D

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Table of Contents

List of Sessions

Mobile

Fixed Active

Fixed Dormant

Filtered list of sessions

Mobile Session with Stream and Measurements

Measurements

Mobile Measurements

Fixed Measurements

All session streams

Averages

Region

Last Session

Sessions for given time range and sensor package name

Parameters description

FAQ

How to encode URLs

FilesExpand file tree

api.md

Latest commit

History

api.md

File metadata and controls

Table of Contents

List of Sessions

Mobile

Fixed Active

Fixed Dormant

Filtered list of sessions

Mobile Session with Stream and Measurements

Measurements

Mobile Measurements

Fixed Measurements

All session streams

Averages

Region

Last Session

Sessions for given time range and sensor package name

Parameters description

FAQ

How to encode URLs