All routesrequirethe following parameters:
latlngAnd they all accept the following optional parameters:
limit- max number of objects per location typeverbose- include meta data in API response (e.g. data counts; bounding box, if specitied)maxdistancekmmaxdistancemilesboundingsquaresizekmboundingsquaresizemilesNote that limit applies to each location type returned by the /near-me/ api.
Also note that, if one of the boundingsquare* parameters is specified and if the endpoint that you're using
returns outlooks, then any outlooks that
overlap with the bounding box will be returned, not just those that
contain the request lat,lng. And the same goes for HMS smoke
plumes (besides the fact that a boolean is returned instead of
the plume polygons).
source (e.g. 'airnow','wrcc', etc.)/near-me/aq-monitors?lat=48.0&lng=-122.1
{
"query":{
"lat":"48.0",
"lng":"-122.1",
"limit":"1"
},
"params":{
"nearByType":"aq-monitors"
},
"aqMonitors":[
{
"unit_id":"1b6a36f981c2e241_840530611007",
"lat":48.0543,
"lng":-122.1715,
"site_name":"Marysville-7th Ave",
"utc_ts":"2022-12-14T19:00:00+00:00",
"local_ts":"2022-12-14T12:00:00+00:00",
"timezone":"America/Los_Angeles",
"source":"AirNow",
"deployment_type": "Permanent",
"device_type": "Monitor",
"raw_pm25":7,
"distanceMiles":5,
"direction":"NE",
"bearing":37.59086697483516
}
]
}/near-me/purple-air?lat=48.0&lng=-122.1&limit=1
{
"query":{
"lat":"48.0",
"lng":"-122.1",
"limit":"1"
},
"params":{
"nearByType":"purple-air"
},
"purpleAir":[
{
"unit_id":"164581",
"lat":48.027775,
"lng":-122.07493,
"utc_ts":"2022-12-14T22:00:00+00:00",
"local_ts":"2022-12-14T15:00:00+00:00",
"timezone":"America/Los_Angeles",
"raw_pm25":8.6,
"corrected_pm25":5.3,
"nowcast":5.5,
"distanceMiles":2.2,
"direction":"NNW",
"bearing":330.9545067719408
}
]
}/near-me/clarity?lat=34.012&lng=-118.536&limit=1
{
"query":{
"lat": "34.012",
"lng": "-118.536",
"limit": "1"
},
"params":{
"nearByType":"clarity"
},
"clarity":[
{
"unit_id": "9q59x5q5w_clarity.DFIVI8588",
"site_name": "DFIVI8588",
"lat": 34.0321,
"lng": -118.512,
"utc_ts": "2025-03-03T22:00:00+00:00",
"local_ts": "2025-03-03T14:00:00-08:00",
"timezone": "America/Los_Angeles",
"raw_pm25": 4.8,
"nowcast": 4.4,
"aqi": 24,
"status": 0,
"latency_mins": 50,
"distanceMiles": 2,
"direction": "NE",
"bearing": 44.694910411796684
}
]
}/near-me/fires?lat=36.8080988&lng=-102.8047927&limit=1
{
"query":{
"lat":"36.8080988",
"lng":"-102.8047927,14.54",
"limit":"1"
},
"params":{
"nearByType":"fires"
},
"fires":[
{
"lat":45.793989,
"lng":-72.422495,
"source":"ANALYSIS",
"satellite":"NOAA 20",
"frp":-999,
"yearday":2022348,
"ecosys":55,
"time":620,
"distanceMiles":null,
"bearing":null
}
]
}/near-me/fasm-fire-incidents?lat=56.64056&lng=-93.7725&limit=1
{
"query": {
"lat": "56.64056",
"lng": "-93.7725",
"limit": "1"
},
"fasmFireIncidents": [
{
"sourceId": 3,
"irwinId": null,
"lat": 56.64056,
"lng": -93.7725,
"incidentName": "No014",
"startTime": "2025-06-01T05:00:00+00:00",
"lastUpdated": "2025-06-10T13:17:00+00:00",
"fireType": "Wildfire",
"fireCause": "Natural",
"fireBehavior": "Out Of Control",
"cumulativeAcres": 0,
"cumulativeHa": 0,
"inciwebUrl": null,
"calfireUrl": null,
"canadianIncidentUrl": "https://www.gov.mb.ca/conservation_fire/Fire-Maps/fireview/fireview.html",
"hasPerimeter": true,
"perimLastUpdated": "2025-06-09T00:00:00+00:00",
"distanceMiles": 0,
"direction": "N",
"bearing": 0
}
]
}/near-me/nifc?lat=36.8080988&lng=-102.8047927&limit=1
{
"query":{
"lat":"36.8080988",
"lng":"-102.8047927,14.54",
"limit":"1"
},
"params":{
"nearByType":"nifc"
},
"nifc":[
{
"lat":45.89847,
"lng":-93.35657,
"irwinID":"b48bf14d-060f-4093-aa93-40a9dd91a6bb",
"incidentName":"312105",
"dailyAcres":0.6,
"percentContained":null,
"fireCause":null,
"uniqueFireIdentifier":"2022-MNMNS-312105",
"createdOn":"2022-11-03T13:22:13+00:00",
"modifiedOn":"2022-11-03T13:22:13+00:00",
"distanceMiles":null,
"bearing":null
}
]
}/near-me/raws-stations?lat=36.8080988&lng=-102.8047927&limit=1
{
"query":{
"lat":"36.8080988",
"lng":"-102.8047927,14.54",
"limit":"1"
},
"params":{
"nearByType":"raws-stations"
},
"rawsStations":[
{
"lat":46.45805556,
"lng":-85.62722222,
"stationId":"201302",
"siteName":"SPINCICH LAKE",
"elevation":896,
"distanceMiles":null,
"bearing":null
}
]
}source (e.g. 'airnow','wrcc', etc.; only applies to AQ monitors){
"query":{
"lat":"45",
"lng":"-123",
"maxdistancemiles":"2",
"verbose": "true"
},
"counts": {
"aqMonitors": 1,
"rawsStations": 0,
"purpleAir": 2,
"clarity": 0,
"fires": 0,
"fasmFireIncidents": 0,
"nifc": 0,
"outlooks": 0
},
boundingSquare": {
"sw": {"lat": 44.9855, "lng": -123.0205},
"nw": {"lat": 45.0145, "lng": -123.0205},
"ne": {"lat": 45.0145, "lng": -122.9795},
"se": {"lat": 44.9855, "lng": -122.9795}
},
"aqMonitors":[
{
"lat":44.9766,
"lng":-122.9763,
"monitorId":"971dc2efb0ce14d2_840410470022",
"siteName":"Salem Chemeketa Community College",
"timezone":"America/Los_Angeles",
"source":"AirNow",
"lastValidUTCTime":"2022-12-21T22:00:00+00:00",
"pm25":2.9,
"distanceMiles":2,
"direction":"SSE",
"bearing":150.96249517656287
}
],
"rawsStations":[],
"purpleAir":[
{
"lat":45.01753,
"lng":-123.01664,
"sensorIndex":"15143",
"ts":"2022-12-22T00:00:00+00:00",
"timezone":"America/Los_Angeles",
"pm25":2.2,
"epaPm25":4.4,
"nowcast":3.9,
"distanceMiles":1.5,
"direction":"NNW",
"bearing":334.23045898808414
},{
"lat":45.005024,
"lng":-123.04028,
"sensorIndex":"20823",
"ts":"2022-12-22T00:00:00+00:00",
"timezone":"America/Los_Angeles",
"pm25":6,
"epaPm25":4.6,
"nowcast":4.7,
"distanceMiles":2,
"direction":"WNW",
"bearing":284.39072055804826
}
],
"clarity":[],
"fires":[],
"fasmFireIncidents":[]
"nifc":[],
"outlooks": [],
"hmsSmoke": false
}