{"info":{"_postman_id":"23f06c05-2811-4fd9-8fc7-26115d85b8b9","name":"AirVisual API","description":"

Interested in using AirVisual's most comprehensive global air quality data for your own application? You are at the right place! Let's get you started.

First of all, please refer to the air quality API page on our website, in order to get familiar with our plans and features.

At any moment, feel free to contact us if you have any questions, would like to trial a particular plan, or any other inquiries. We are always happy to hear from you!

Get started

The only thing you need to start using our service is an API key, to obtain one for free please go to this page.

Once you have it, you need to put it everywhere you see the {{YOUR_API_KEY}} string, either directly throught Postman (recommended) using global variables, in your browser or any other system/language you may use.

HTTPS support

AirVisual API now supports HTTPS! In order to enable this feature, just prefix your request with https://... instead of http://...

Important notes

Stations around the world have update cycles that are all different from each other.
\n
Stations are updated only once per hour.
\n
The API returns calculated AQI for each pollutant and for the station (main pollutant).
\n
The API returns 2 types of AQI: US AQI (EPA) and Chinese AQI.
\n
Stations may occasionally have updated information. For example, their GPS coordinates may be adjusted or their name changed. Make sure your system or apps support the station info updates.
\n
If a station doesn’t return pollution values, it means the data wasn’t published for that particular hour.
\n
Pollutants do not always have the same concentration units. Sometimes CO is reported in µg/m3 and sometimes in ppm. However, PM2.5 and PM10 are always reported in µg/m3.
\n

Return codes

Below are a few example of return codes you may get. This list is not exhaustive.

success: returned when JSON file was generated successfully.
\n
call_limit_reached: returned when minute/monthly limit is reached.
\n
api_key_expired: returned when API key is expired.
\n
incorrect_api_key: returned when using wrong API key.
\n
ip_location_failed: returned when service is unable to locate IP address of request.
\n
no_nearest_station: returned when there is no nearest station within specified radius.
\n
feature_not_available: returned when call requests a feature that is not available in chosen subscription plan.
\n
too_many_requests: returned when more than 10 calls per second are made.
\n

Detailed response example

{\n  \"status\": \"success\",\n  \"data\": {\n    \"name\": \"Eilat Harbor\",\n    \"city\": \"Eilat\",\n    \"state\": \"South District\",\n    \"country\": \"Israel\",\n    \"location\": {\n      \"type\": \"Point\",\n      \"coordinates\": [\n        34.939443,\n        29.531814\n      ]\n    },\n    \"forecasts\": [ //object containing forecast information\n      {\n        \"ts\": \"2017-02-01T03:00:00.000Z\", //timestamp\n        \"aqius\": 21, //AQI value based on US EPA standard\n        \"aqicn\": 7, //AQI value based on China MEP standard\n        \"tp\": 33, //temperature in Celsius\n        \"tp_min\": 33, //minimum temperature in Celsius\n        \"pr\": 976, //atmospheric pressure in hPa\n        \"hu\": 62, //humidity %\n        \"ws\": 3, //wind speed (m/s)\n        \"wd\": 313, //wind direction, as an angle of 360° (N=0, E=90, S=180, W=270)\n        \"ic\": \"10n\" //weather icon code, see below for icon index\n        \"pop\": 0, // probability of precipitation %\n        \"pm10\": 183.05,\n        \"pm25\": 66.96\n        \"conc\": 45.71, // concentration for pm25,we keep 2 decimals\n        \"heatIndex\": 40 // apparent temperature in Celsius, calculated from temperature and relative humidity, following https://www.wpc.ncep.noaa.gov/html/heatindex_equation.shtml \n      }, \n    … // contains more forecast data for upcoming 76 hours\n    ],\n    \"current\": {\n      \"weather\": {\n        \"ts\": \"2017-02-01T01:00:00.000Z\", //timestamp\n        \"tp\": 36, //temperature in Celsius\n        \"pr\": 1020, //atmospheric pressure in hPa\n        \"hu\": 38, //humidity %\n        \"ws\": 2, //wind speed (m/s)\n        \"wd\": 320, //wind direction, as an angle of 360° (N=0, E=90, S=180, W=270)\n        \"ic\": \"01n\", //weather icon code, see below for icon index\n        \"heatIndex\": 38 // apparent temperature in Celsius, calculated from temperature and relative humidity, following https://www.wpc.ncep.noaa.gov/html/heatindex_equation.shtml \n      },\n      \"pollution\": {\n        \"ts\": \"2017-02-01T01:15:00.000Z\", //timestamp\n        \"aqius\": 18, //AQI value based on US EPA standard\n        \"mainus\": \"p1\", //main pollutant for US AQI\n        \"aqicn\": 20, //AQI value based on China MEP standard\n        \"maincn\": \"p1\", //main pollutant for Chinese AQI\n        \"p1\": { //pollutant details, concentration and appropriate AQIs\n          \"conc\": 20,\n          \"aqius\": 18,\n          \"aqicn\": 20\n        }\n      }\n    },\n    \"forecasts_daily\": [\n      {\n        \"ts\": \"2025-08-06T00:00:00.000Z\",\n        \"tp\": 36,\n        \"tp_min\": 25,\n        \"pr\": 1002,\n        \"hu\": 47,\n        \"ws\": 2,\n        \"wd\": 347,\n        \"pop\": 80,\n        \"ic\": \"03d\",\n        \"heatIndex\": 41,\n        \"aqius\": 126,\n        \"aqicn\": 70\n      },\n      ... // contains more daily forecast data for next 7 days\n    ],\n    \"history\": { //object containing weather and pollution history information\n      \"weather\": [\n        {\n          \"ts\": \"2017-02-01T01:00:00.000Z\",\n          \"tp\": 12,\n          \"pr\": 1020,\n          \"hu\": 62,\n          \"ws\": 2,\n          \"wd\": 320,\n          \"ic\": \"01n\"\n        },\n        … // contains more weather historical data for past 48 hours\n      ]\n      \"pollution\": [\n        {\n          \"ts\": \"2017-02-01T01:15:00.000Z\",\n          \"aqius\": 18,\n          \"mainus\": \"p1\",\n          \"aqicn\": 20,\n          \"maincn\": \"p1\",\n          \"p1\": {\n            \"conc\": 20,\n            \"aqius\": 18,\n            \"aqicn\": 20\n          }\n        },\n      … // contains more pollution historical data for past 48 hours\n      ]\n    },\n    \"units\": { //object containing units information\n      \"p2\": \"ugm3\", //pm2.5\n      \"p1\": \"ugm3\", //pm10\n      \"o3\": \"ppb\", //Ozone O3\n      \"n2\": \"ppb\", //Nitrogen dioxide NO2 \n      \"s2\": \"ppb\", //Sulfur dioxide SO2 \n      \"co\": \"ppm\" //Carbon monoxide CO \n    }\n  }\n}\n\n

Weather icon index

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n

Description	Name	Icon
clear sky (day)	01d.png	$\"\"$
clear sky (night)	01n.png	$\"\"$
few clouds (day)	02d.png	$\"\"$
few clouds (night)	02n.png	$\"\"$
scattered clouds	03d.png	$\"\"$
broken clouds	04d.png	$\"\"$
shower rain	09d.png	$\"\"$
rain (day time)	10d.png	$\"\"$
rain (night time)	10n.png	$\"\"$
thunderstorm	11d.png	$\"\"$
snow	13d.png	$\"\"$
mist	50d.png	$\"\"$

Changelog

Version 2.1.3 `08/09/2025`

Rename heat_index to heatIndex

Version 2.1.2 `06/08/2025`

Now support heat index as a “felt temperature” for stations/cities as field “heatIndex”, calculated from temperature and relative humidity, following the definition from NOAA (U.S. National Oceanic and Atmospheric Administration).

Version 2.1.1 `27/09/2017`

Now dynamically hides states/countries which have no active stations
\n
Deprecated local_name field.
\n

Version 2.1 `15/09/2017`

Moved documentation onto Postman Docs system.
\n
Added HTTPS support.
\n
Create new endpoint countries.
\n
Create new endpoint states.
\n
Create new endpointcities.
\n
Create new endpointstations.
\n
Create new endpointstation (startup api plan and above).
\n
Improve city_ranking endpoint.
\n

Version 2.0 `06/02/2017`

Consolidates multiple API calls and provides better structure to API response.

Structure is controlled by the subscription plan.

Create changelog
\n
Create new endpoint nearest_city.
\n
Create new endpoint city.
\n
Create new endpoint nearest_station (startup api plan and above).
\n
Create new endpoint city_ranking (enterprise only).
\n

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"Get started","slug":"get-started"},{"content":"HTTPS support","slug":"https-support"},{"content":"Important notes","slug":"important-notes"},{"content":"Return codes","slug":"return-codes"},{"content":"Detailed response example","slug":"detailed-response-example"},{"content":"Changelog","slug":"changelog"}],"owner":"6466593","collectionId":"23f06c05-2811-4fd9-8fc7-26115d85b8b9","publishedId":"T1DmDyYs","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"EF5B25"},"publishDate":"2020-12-16T08:25:56.000Z"},"item":[{"name":"Version 2","item":[{"name":"Community","item":[{"name":"List supported countries","event":[{"listen":"test","script":{"id":"da7777fa-1b78-4f36-97d3-3d79ff199547","exec":["tests[\"Status code is 200\"] = responseCode.code === 200;","","","var jsonData = JSON.parse(responseBody).data;","tests[\"List is not empty\"] = jsonData.length !== 0;"],"type":"text/javascript"}}],"id":"e399e494-f3d8-435f-aca8-46c760c1297f","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{urlExternalAPI}}v2/countries?key={{YOUR_API_KEY}}","description":"

Return an array of all supported countries*.

* countries with no active stations will not be returned

Each country object contains its English name country (requested by other endpoints)

\n","urlObject":{"path":["countries"],"host":["{{urlExternalAPI}}v2"],"query":[{"description":{"content":"

Your api key

\n","type":"text/plain"},"key":"key","value":"{{YOUR_API_KEY}}"}],"variable":[]}},"response":[{"id":"5a8e1edb-7b95-44f3-b4c6-6819cbd7c7ca","name":"All","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":{"raw":"{{urlExternalAPI}}v2/countries?key={{YOUR_API_KEY}}","host":["{{urlExternalAPI}}v2"],"path":["countries"],"query":[{"key":"key","value":"{{YOUR_API_KEY}}","description":"Your api key"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"name":"access-control-allow-headers","key":"access-control-allow-headers","value":"Origin, X-Requested-With, Content-Type, Accept","description":""},{"name":"access-control-allow-origin","key":"access-control-allow-origin","value":"*","description":""},{"name":"cache-control","key":"cache-control","value":"no-store","description":""},{"name":"connection","key":"connection","value":"keep-alive","description":""},{"name":"content-encoding","key":"content-encoding","value":"gzip","description":""},{"name":"content-type","key":"content-type","value":"application/json","description":""},{"name":"date","key":"date","value":"Fri, 15 Sep 2017 09:39:25 GMT","description":""},{"name":"pragma","key":"pragma","value":"no-cache","description":""},{"name":"transfer-encoding","key":"transfer-encoding","value":"chunked","description":""},{"name":"vary","key":"vary","value":"Accept-Encoding","description":""}],"cookie":[],"responseTime":"33","body":"{\"status\":\"success\",\"data\":[{\"country\":\"Andorra\"},{\"country\":\"Argentina\"},{\"country\":\"Australia\"},{\"country\":\"Austria\"},{\"country\":\"Bahamas\"},{\"country\":\"Bahrain\"},{\"country\":\"Bangladesh\"},{\"country\":\"Belgium\"},{\"country\":\"Bosnia Herzegovina\"},{\"country\":\"Brazil\"},{\"country\":\"Cambodia\"},{\"country\":\"Canada\"},{\"country\":\"Chile\"},{\"country\":\"China\"},{\"country\":\"Colombia\"},{\"country\":\"Croatia\"},{\"country\":\"Cyprus\"},{\"country\":\"Czech Republic\"},{\"country\":\"Denmark\"},{\"country\":\"Ethiopia\"},{\"country\":\"Finland\"},{\"country\":\"France\"},{\"country\":\"Germany\"},{\"country\":\"Hungary\"},{\"country\":\"India\"},{\"country\":\"Indonesia\"},{\"country\":\"Iran\"},{\"country\":\"Ireland\"},{\"country\":\"Israel\"},{\"country\":\"Italy\"},{\"country\":\"Japan\"},{\"country\":\"Kosovo\"},{\"country\":\"Kuwait\"},{\"country\":\"Latvia\"},{\"country\":\"Lithuania\"},{\"country\":\"Macedonia\"},{\"country\":\"Malaysia\"},{\"country\":\"Malta\"},{\"country\":\"Mauritius\"},{\"country\":\"Mexico\"},{\"country\":\"Mongolia\"},{\"country\":\"Nepal\"},{\"country\":\"Netherlands\"},{\"country\":\"New Zealand\"},{\"country\":\"Nigeria\"},{\"country\":\"Norway\"},{\"country\":\"Pakistan\"},{\"country\":\"Peru\"},{\"country\":\"Philippines\"},{\"country\":\"Poland\"},{\"country\":\"Portugal\"},{\"country\":\"Romania\"},{\"country\":\"Russia\"},{\"country\":\"Saudi Arabia\"},{\"country\":\"Serbia\"},{\"country\":\"Singapore\"},{\"country\":\"Slovakia\"},{\"country\":\"South Africa\"},{\"country\":\"South Korea\"},{\"country\":\"Spain\"},{\"country\":\"Sweden\"},{\"country\":\"Switzerland\"},{\"country\":\"Taiwan\"},{\"country\":\"Thailand\"},{\"country\":\"Turkey\"},{\"country\":\"USA\"},{\"country\":\"Uganda\"},{\"country\":\"Ukraine\"},{\"country\":\"United Arab Emirates\"},{\"country\":\"United Kingdom\"},{\"country\":\"Vietnam\"}]}"}],"_postman_id":"e399e494-f3d8-435f-aca8-46c760c1297f"},{"name":"List supported states in a country","event":[{"listen":"test","script":{"type":"text/javascript","exec":["tests[\"Status code is 200\"] = responseCode.code === 200;","","var jsonData = JSON.parse(responseBody).data;","tests[\"List is not empty\"] = jsonData.length !== 0;"]}}],"id":"42e21e2a-aaec-41fc-8049-da74124da9a4","request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"{{urlExternalAPI}}v2/states?country={{COUNTRY_NAME}}&key={{YOUR_API_KEY}}","description":"

Return an array of all supported states*, inside a specified country.

* states with no active stations will not be returned

Each state object contains its English name state (requested by other endpoints)

Parameters

country: country's English name, can be found using the respective listing endpoint.

\n","urlObject":{"path":["states"],"host":["{{urlExternalAPI}}v2"],"query":[{"key":"country","value":"{{COUNTRY_NAME}}"},{"key":"key","value":"{{YOUR_API_KEY}}"}],"variable":[]}},"response":[{"id":"c82a792b-42cb-46bd-b531-816985b16ef1","name":"China","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":{"raw":"{{urlExternalAPI}}v2/states?country=China&key={{YOUR_API_KEY}}","host":["{{urlExternalAPI}}v2"],"path":["states"],"query":[{"key":"country","value":"China"},{"key":"key","value":"{{YOUR_API_KEY}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"name":"access-control-allow-headers","key":"access-control-allow-headers","value":"Origin, X-Requested-With, Content-Type, Accept","description":""},{"name":"access-control-allow-origin","key":"access-control-allow-origin","value":"*","description":""},{"name":"cache-control","key":"cache-control","value":"no-store","description":""},{"name":"connection","key":"connection","value":"keep-alive","description":""},{"name":"content-encoding","key":"content-encoding","value":"gzip","description":""},{"name":"content-type","key":"content-type","value":"application/json","description":""},{"name":"date","key":"date","value":"Fri, 15 Sep 2017 09:49:08 GMT","description":""},{"name":"pragma","key":"pragma","value":"no-cache","description":""},{"name":"transfer-encoding","key":"transfer-encoding","value":"chunked","description":""},{"name":"vary","key":"vary","value":"Accept-Encoding","description":""}],"cookie":[],"responseTime":"35","body":"{\"status\":\"success\",\"data\":[{\"state\":\"Anhui\"},{\"state\":\"Beijing\"},{\"state\":\"Chongqing\"},{\"state\":\"Fujian\"},{\"state\":\"Gansu\"},{\"state\":\"Guangdong\"},{\"state\":\"Guangxi\"},{\"state\":\"Guizhou\"},{\"state\":\"Hainan\"},{\"state\":\"Hebei\"},{\"state\":\"Heilongjiang\"},{\"state\":\"Henan\"},{\"state\":\"Hong Kong\"},{\"state\":\"Hubei\"},{\"state\":\"Hunan\"},{\"state\":\"Jiangsu\"},{\"state\":\"Jiangxi\"},{\"state\":\"Jilin\"},{\"state\":\"Liaoning\"},{\"state\":\"Neimenggu\"},{\"state\":\"Ningxia\"},{\"state\":\"Qinghai\"},{\"state\":\"Shaanxi\"},{\"state\":\"Shandong\"},{\"state\":\"Shanghai\"},{\"state\":\"Shanxi\"},{\"state\":\"Sichuan\"},{\"state\":\"Tianjin\"},{\"state\":\"Xinjiang\"},{\"state\":\"Xizang (Tibet)\"},{\"state\":\"Yunnan\"},{\"state\":\"Zhejiang\"}]}"},{"id":"f3938a92-6c59-4d0b-a9e1-dcd67b21b113","name":"USA","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":{"raw":"{{urlExternalAPI}}v2/states?country=USA&key={{YOUR_API_KEY}}","host":["{{urlExternalAPI}}v2"],"path":["states"],"query":[{"key":"country","value":"USA"},{"key":"key","value":"{{YOUR_API_KEY}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"name":"access-control-allow-headers","key":"access-control-allow-headers","value":"Origin, X-Requested-With, Content-Type, Accept","description":""},{"name":"access-control-allow-origin","key":"access-control-allow-origin","value":"*","description":""},{"name":"cache-control","key":"cache-control","value":"no-store","description":""},{"name":"connection","key":"connection","value":"keep-alive","description":""},{"name":"content-encoding","key":"content-encoding","value":"gzip","description":""},{"name":"content-type","key":"content-type","value":"application/json","description":""},{"name":"date","key":"date","value":"Fri, 15 Sep 2017 09:48:39 GMT","description":""},{"name":"pragma","key":"pragma","value":"no-cache","description":""},{"name":"transfer-encoding","key":"transfer-encoding","value":"chunked","description":""},{"name":"vary","key":"vary","value":"Accept-Encoding","description":""}],"cookie":[],"responseTime":"69","body":"{\"status\":\"success\",\"data\":[{\"state\":\"AR\"},{\"state\":\"Alabama\"},{\"state\":\"Alaska\"},{\"state\":\"Arizona\"},{\"state\":\"Arkansas\"},{\"state\":\"California\"},{\"state\":\"Colorado\"},{\"state\":\"Connecticut\"},{\"state\":\"Delaware\"},{\"state\":\"District Of Columbia\"},{\"state\":\"Florida\"},{\"state\":\"Georgia\"},{\"state\":\"Hawaii\"},{\"state\":\"Idaho\"},{\"state\":\"Illinois\"},{\"state\":\"Indiana\"},{\"state\":\"Iowa\"},{\"state\":\"Kansas\"},{\"state\":\"Kentucky\"},{\"state\":\"Louisiana\"},{\"state\":\"Maine\"},{\"state\":\"Maryland\"},{\"state\":\"Massachusetts\"},{\"state\":\"Michigan\"},{\"state\":\"Minnesota\"},{\"state\":\"Mississippi\"},{\"state\":\"Missouri\"},{\"state\":\"Mm\"},{\"state\":\"Montana\"},{\"state\":\"Mx\"},{\"state\":\"Nebraska\"},{\"state\":\"Nevada\"},{\"state\":\"New Hampshire\"},{\"state\":\"New Jersey\"},{\"state\":\"New Mexico\"},{\"state\":\"New York\"},{\"state\":\"North Carolina\"},{\"state\":\"North Dakota\"},{\"state\":\"Ohio\"},{\"state\":\"Oklahoma\"},{\"state\":\"Oregon\"},{\"state\":\"Pennsylvania\"},{\"state\":\"Puerto Rico\"},{\"state\":\"Rhode Island\"},{\"state\":\"South Carolina\"},{\"state\":\"South Dakota\"},{\"state\":\"Tennessee\"},{\"state\":\"Texas\"},{\"state\":\"Utah\"},{\"state\":\"Vermont\"},{\"state\":\"Virginia\"},{\"state\":\"Washington\"},{\"state\":\"West Virginia\"},{\"state\":\"Wisconsin\"},{\"state\":\"Wyoming\"}]}"}],"_postman_id":"42e21e2a-aaec-41fc-8049-da74124da9a4"},{"name":"List supported cities in a state","event":[{"listen":"test","script":{"type":"text/javascript","exec":["tests[\"Status code is 200\"] = responseCode.code === 200;","","var jsonData = JSON.parse(responseBody).data;","tests[\"List is not empty\"] = jsonData.length !== 0;"]}}],"id":"a9daaea5-4527-4991-a6d7-a66368c85e71","request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"{{urlExternalAPI}}v2/cities?state={{STATE_NAME}}&country={{COUNTRY_NAME}}&key={{YOUR_API_KEY}}","description":"

Return an array of all supported cities*, inside a specified state.

* cities with no active stations will not be returned

Each city object contains its English name city (requested by other endpoints)

Parameters

state: state's English name, can be found using the respective listing endpoint.
country: country's English name, can be found using the respective listing endpoint.

\n","urlObject":{"path":["cities"],"host":["{{urlExternalAPI}}v2"],"query":[{"key":"state","value":"{{STATE_NAME}}"},{"key":"country","value":"{{COUNTRY_NAME}}"},{"key":"key","value":"{{YOUR_API_KEY}}"}],"variable":[]}},"response":[{"id":"7904ad9f-670b-4f43-b7be-42763c716866","name":"New York, USA","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":{"raw":"{{urlExternalAPI}}v2/cities?state=New York&country=USA&key={{YOUR_API_KEY}}","host":["{{urlExternalAPI}}v2"],"path":["cities"],"query":[{"key":"state","value":"New York"},{"key":"country","value":"USA"},{"key":"key","value":"{{YOUR_API_KEY}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"name":"access-control-allow-headers","key":"access-control-allow-headers","value":"Origin, X-Requested-With, Content-Type, Accept","description":""},{"name":"access-control-allow-origin","key":"access-control-allow-origin","value":"*","description":""},{"name":"cache-control","key":"cache-control","value":"no-store","description":""},{"name":"connection","key":"connection","value":"keep-alive","description":""},{"name":"content-encoding","key":"content-encoding","value":"gzip","description":""},{"name":"content-type","key":"content-type","value":"application/json","description":""},{"name":"date","key":"date","value":"Fri, 15 Sep 2017 09:51:00 GMT","description":""},{"name":"pragma","key":"pragma","value":"no-cache","description":""},{"name":"transfer-encoding","key":"transfer-encoding","value":"chunked","description":""},{"name":"vary","key":"vary","value":"Accept-Encoding","description":""}],"cookie":[],"responseTime":"36","body":"{\"status\":\"success\",\"data\":[{\"city\":\"Addison\"},{\"city\":\"Albany\"},{\"city\":\"Buffalo\"},{\"city\":\"Carmel\"},{\"city\":\"Dunkirk\"},{\"city\":\"East Syracuse\"},{\"city\":\"Farmingdale\"},{\"city\":\"Holtsville\"},{\"city\":\"Ithaca\"},{\"city\":\"La Fargeville\"},{\"city\":\"Malone\"},{\"city\":\"Middleport\"},{\"city\":\"Millbrook\"},{\"city\":\"Montgomery\"},{\"city\":\"New York\"},{\"city\":\"New York-northern New Jersey-long Island\"},{\"city\":\"Newburgh\"},{\"city\":\"Newcomb\"},{\"city\":\"Old Forge\"},{\"city\":\"Piseco\"},{\"city\":\"Pomona\"},{\"city\":\"Ps 314\"},{\"city\":\"Riverhead\"},{\"city\":\"Rochester\"},{\"city\":\"Stillwater\"},{\"city\":\"Tonawanda\"},{\"city\":\"Utica\"},{\"city\":\"White Plains\"},{\"city\":\"Williamson\"},{\"city\":\"Williston\"},{\"city\":\"Wilmington\"}]}"},{"id":"f39f7d5e-8889-4047-b39c-b4262ea34ea2","name":"Guangdong, China","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":{"raw":"{{urlExternalAPI}}v2/cities?state=Guangdong&country=China&key={{YOUR_API_KEY}}","host":["{{urlExternalAPI}}v2"],"path":["cities"],"query":[{"key":"state","value":"Guangdong"},{"key":"country","value":"China"},{"key":"key","value":"{{YOUR_API_KEY}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"name":"access-control-allow-headers","key":"access-control-allow-headers","value":"Origin, X-Requested-With, Content-Type, Accept","description":""},{"name":"access-control-allow-origin","key":"access-control-allow-origin","value":"*","description":""},{"name":"cache-control","key":"cache-control","value":"no-store","description":""},{"name":"connection","key":"connection","value":"keep-alive","description":""},{"name":"content-encoding","key":"content-encoding","value":"gzip","description":""},{"name":"content-type","key":"content-type","value":"application/json","description":""},{"name":"date","key":"date","value":"Fri, 15 Sep 2017 09:51:59 GMT","description":""},{"name":"pragma","key":"pragma","value":"no-cache","description":""},{"name":"transfer-encoding","key":"transfer-encoding","value":"chunked","description":""},{"name":"vary","key":"vary","value":"Accept-Encoding","description":""}],"cookie":[],"responseTime":"45","body":"{\"status\":\"success\",\"data\":[{\"city\":\"Chaozhou\"},{\"city\":\"Dongguan\"},{\"city\":\"Foshan\"},{\"city\":\"Guangdong\"},{\"city\":\"Guangzhou\"},{\"city\":\"Heyuan\"},{\"city\":\"Huizhou\"},{\"city\":\"Jiangmen\"},{\"city\":\"Jieyang\"},{\"city\":\"Maoming\"},{\"city\":\"Meizhou\"},{\"city\":\"Qingyuan\"},{\"city\":\"Shantou\"},{\"city\":\"Shanwei\"},{\"city\":\"Shaoguan\"},{\"city\":\"Shenzhen\"},{\"city\":\"Yangjiang\"},{\"city\":\"Yunfu\"},{\"city\":\"Zhanjiang\"},{\"city\":\"Zhaoqing\"},{\"city\":\"Zhongshan\"},{\"city\":\"Zhuhai\"}]}"}],"_postman_id":"a9daaea5-4527-4991-a6d7-a66368c85e71"},{"name":"Get nearest city data (IP geolocation)","event":[{"listen":"test","script":{"id":"af596448-db9f-4461-97fa-2a533e667859","exec":["tests[\"Status code is 200\"] = responseCode.code === 200;","","","","var jsonData = JSON.parse(responseBody).data;","tests[\"City field is not empty\"] = (jsonData.city && 0 !== jsonData.city.length);"],"type":"text/javascript","packages":{}}}],"id":"376c20f8-b338-404b-851e-2ed244104ca5","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-forwarded-for","value":"27.102.113.160","type":"text"}],"url":"{{urlExternalAPI}}v2/nearest_city?key={{YOUR_API_KEY}}","description":"

Return nearest city's data, using IP address geolocation.

Values returned in the object depends on you API plan, please refer to the API page on our website to check which values and level of detail your API plan allows you to access.

\n","urlObject":{"path":["nearest_city"],"host":["{{urlExternalAPI}}v2"],"query":[{"key":"key","value":"{{YOUR_API_KEY}}"}],"variable":[]}},"response":[{"id":"1be71037-bc2f-4d06-8719-57071f320926","name":"Yongsan-dong Korea","originalRequest":{"method":"GET","header":[{"key":"x-forwarded-for","value":"27.102.113.160","type":"text"}],"url":{"raw":"{{urlExternalAPI}}v2/nearest_city?key={{YOUR_API_KEY}}","host":["{{urlExternalAPI}}v2"],"path":["nearest_city"],"query":[{"key":"key","value":"{{YOUR_API_KEY}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":null,"header":[{"key":"Connection","value":"close"},{"key":"Transfer-Encoding","value":"chunked"},{"key":"Access-Control-Allow-Credentials","value":"true"},{"key":"Access-Control-Allow-Headers","value":"Origin,X-Requested-With,Content-Type,Accept"},{"key":"Access-Control-Allow-Methods","value":"GET, POST, HEAD, OPTIONS, PUT, PATCH, DELETE"},{"key":"Access-Control-Allow-Origin","value":"*"},{"key":"Cache-Control","value":"no-store, no-cache"},{"key":"Content-Encoding","value":"gzip"},{"key":"Content-Type","value":"application/json; charset=utf-8"},{"key":"Date","value":"Mon, 08 Sep 2025 08:34:45 GMT"},{"key":"Server","value":"nginx/1.29.1"},{"key":"Vary","value":"Accept-Encoding"},{"key":"X-Ratelimit-Limit","value":"10000000"},{"key":"X-Ratelimit-Remaining","value":"9999988"}],"cookie":[],"responseTime":null,"body":"{\n \"status\": \"success\",\n \"data\": {\n \"city\": \"Yongsan-dong\",\n \"state\": \"Seoul\",\n \"country\": \"South Korea\",\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": [\n 126.990597,\n 37.532171\n ]\n },\n \"current\": {\n \"pollution\": {\n \"ts\": \"2025-09-08T08:00:00.000Z\",\n \"aqius\": 62,\n \"mainus\": \"o3\",\n \"aqicn\": 48,\n \"maincn\": \"o3\"\n },\n \"weather\": {\n \"ts\": \"2025-09-08T08:00:00.000Z\",\n \"ic\": \"04d\",\n \"hu\": 60,\n \"pr\": 1010,\n \"tp\": 26,\n \"wd\": 278,\n \"ws\": 3.5,\n \"heatIndex\": 26\n }\n }\n }\n}"}],"_postman_id":"376c20f8-b338-404b-851e-2ed244104ca5"},{"name":"Get nearest city data (GPS coordinates)","event":[{"listen":"test","script":{"type":"text/javascript","exec":["tests[\"Status code is 200\"] = responseCode.code === 200;","","var jsonData = JSON.parse(responseBody).data;","tests[\"City field is not empty\"] = (jsonData.city && 0 !== jsonData.city.length);"]}}],"id":"5ea0dcc1-78c3-4939-aa80-6d4929646b82","request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"{{urlExternalAPI}}v2/nearest_city?lat={{LATITUDE}}&lon={{LONGITUDE}}&key={{YOUR_API_KEY}}","description":"

Return nearest city's data, using a specified set of GPS coordinates.

Values returned in the object depends on you API plan, please refer to the API page on our website to check which values and level of detail your API plan allows you to access.

Parameters

lat: Latitude numerical value, within range [-90, 90].
\n
lon: Longitude numerical value, within range [-180, 180].
\n

\n","urlObject":{"path":["nearest_city"],"host":["{{urlExternalAPI}}v2"],"query":[{"key":"lat","value":"{{LATITUDE}}"},{"key":"lon","value":"{{LONGITUDE}}"},{"key":"key","value":"{{YOUR_API_KEY}}"}],"variable":[]}},"response":[{"id":"069b585c-b7ab-4558-8d63-0a00a1e99194","name":"Inashiki, Japan","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{urlExternalAPI}}v2/nearest_city?lat=35.98&lon=140.33&key={{YOUR_API_KEY}}","host":["{{urlExternalAPI}}v2"],"path":["nearest_city"],"query":[{"key":"lat","value":"35.98"},{"key":"lon","value":"140.33"},{"key":"key","value":"{{YOUR_API_KEY}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"access-control-allow-headers","value":"Origin, X-Requested-With, Content-Type, Accept","description":""},{"key":"access-control-allow-origin","value":"*","description":""},{"key":"cache-control","value":"no-store","description":""},{"key":"connection","value":"keep-alive","description":""},{"key":"content-encoding","value":"gzip","description":""},{"key":"content-type","value":"application/json","description":""},{"key":"date","value":"Fri, 15 Sep 2017 10:31:41 GMT","description":""},{"key":"pragma","value":"no-cache","description":""},{"key":"transfer-encoding","value":"chunked","description":""},{"key":"vary","value":"Accept-Encoding","description":""}],"cookie":[],"responseTime":"37","body":"{\n \"status\": \"success\",\n \"data\": {\n \"city\": \"Inashiki\",\n \"state\": \"Ibaraki\",\n \"country\": \"Japan\",\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": [\n 140.32356,\n 35.95633\n ]\n },\n \"current\": {\n \"pollution\": {\n \"ts\": \"2025-09-08T08:00:00.000Z\",\n \"aqius\": 66,\n \"mainus\": \"p2\",\n \"aqicn\": 24,\n \"maincn\": \"p2\"\n },\n \"weather\": {\n \"ts\": \"2025-09-08T08:00:00.000Z\",\n \"ic\": \"01d\",\n \"hu\": 72,\n \"pr\": 1008,\n \"tp\": 29,\n \"wd\": 47,\n \"ws\": 3.66,\n \"heatIndex\": 33\n }\n }\n }\n}"},{"id":"71ce3a9e-91f9-49e8-8695-8166cb9c7f09","name":"St. John's, Canada","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{urlExternalAPI}}v2/nearest_city?lat=47.6528&lon=-52.8167&key={{YOUR_API_KEY}}","host":["{{urlExternalAPI}}v2"],"path":["nearest_city"],"query":[{"key":"lat","value":"47.6528"},{"key":"lon","value":"-52.8167"},{"key":"key","value":"{{YOUR_API_KEY}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"access-control-allow-headers","value":"Origin, X-Requested-With, Content-Type, Accept","description":""},{"key":"access-control-allow-origin","value":"*","description":""},{"key":"cache-control","value":"no-store","description":""},{"key":"connection","value":"keep-alive","description":""},{"key":"content-encoding","value":"gzip","description":""},{"key":"content-type","value":"application/json","description":""},{"key":"date","value":"Fri, 15 Sep 2017 09:52:54 GMT","description":""},{"key":"pragma","value":"no-cache","description":""},{"key":"transfer-encoding","value":"chunked","description":""},{"key":"vary","value":"Accept-Encoding","description":""}],"cookie":[],"responseTime":"403","body":"{\n \"status\": \"success\",\n \"data\": {\n \"city\": \"St. John's\",\n \"state\": \"Newfoundland and Labrador\",\n \"country\": \"Canada\",\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": [\n -52.8167,\n 47.6528\n ]\n },\n \"current\": {\n \"pollution\": {\n \"ts\": \"2025-09-08T06:00:00.000Z\",\n \"aqius\": 8,\n \"mainus\": \"p2\",\n \"aqicn\": 2,\n \"maincn\": \"p2\"\n },\n \"weather\": {\n \"ts\": \"2025-09-08T08:00:00.000Z\",\n \"ic\": \"04n\",\n \"hu\": 97,\n \"pr\": 1016,\n \"tp\": 16,\n \"wd\": 223,\n \"ws\": 7.53,\n \"heatIndex\": 16\n }\n }\n }\n}"}],"_postman_id":"5ea0dcc1-78c3-4939-aa80-6d4929646b82"},{"name":"Get specified city data","event":[{"listen":"test","script":{"id":"84ed4f37-e2a8-4633-bee6-17911adffa8f","exec":["tests[\"Status code is 200\"] = responseCode.code === 200;","","var jsonData = JSON.parse(responseBody).data;","tests[\"City field is not empty\"] = (jsonData.city && 0 !== jsonData.city.length);"],"type":"text/javascript"}}],"id":"5bc93d6b-d563-43dc-adb9-c266b2e96d4a","request":{"method":"GET","header":[],"url":"{{urlExternalAPI}}v2/city?city=Los Angeles&state=California&country=USA&key={{YOUR_API_KEY}}","description":"

Return specified city's data object.

Values returned in the object depends on you API plan, please refer to the API page on our website to check which values and level of detail your API plan allows you to access.

Parameters

city: city's English name, can be found using the respective listing endpoint.
state: state's English name, can be found using the respective listing endpoint.
country: country's English name, can be found using the respective listing endpoint.

\n","urlObject":{"path":["city"],"host":["{{urlExternalAPI}}v2"],"query":[{"key":"city","value":"Los Angeles"},{"key":"state","value":"California"},{"key":"country","value":"USA"},{"key":"key","value":"{{YOUR_API_KEY}}"}],"variable":[]}},"response":[{"id":"36b2baa9-d9f8-4850-9cbb-edee5865effa","name":"Los Angeles, USA","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{urlExternalAPI}}v2/city?city=Los Angeles&state=California&country=USA&key={{YOUR_API_KEY}}","host":["{{urlExternalAPI}}v2"],"path":["city"],"query":[{"key":"city","value":"Los Angeles"},{"key":"state","value":"California"},{"key":"country","value":"USA"},{"key":"key","value":"{{YOUR_API_KEY}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"access-control-allow-headers","value":"Origin, X-Requested-With, Content-Type, Accept","description":""},{"key":"access-control-allow-origin","value":"*","description":""},{"key":"cache-control","value":"no-store","description":""},{"key":"connection","value":"keep-alive","description":""},{"key":"content-encoding","value":"gzip","description":""},{"key":"content-type","value":"application/json","description":""},{"key":"date","value":"Fri, 15 Sep 2017 10:05:28 GMT","description":""},{"key":"pragma","value":"no-cache","description":""},{"key":"transfer-encoding","value":"chunked","description":""},{"key":"vary","value":"Accept-Encoding","description":""}],"cookie":[],"responseTime":"1003","body":"{\n \"status\": \"success\",\n \"data\": {\n \"city\": \"Los Angeles\",\n \"state\": \"California\",\n \"country\": \"USA\",\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": [\n -118.4108248,\n 34.0193936\n ]\n },\n \"current\": {\n \"pollution\": {\n \"ts\": \"2025-09-08T08:00:00.000Z\",\n \"aqius\": 36,\n \"mainus\": \"p2\",\n \"aqicn\": 19,\n \"maincn\": \"p1\"\n },\n \"weather\": {\n \"ts\": \"2025-09-08T08:00:00.000Z\",\n \"ic\": \"01n\",\n \"hu\": 66,\n \"pr\": 1017,\n \"tp\": 20,\n \"wd\": 146,\n \"ws\": 1.57,\n \"heatIndex\": 20\n }\n }\n }\n}"},{"id":"e80aff65-6405-4ee4-806d-040dfac188b5","name":"Paris, France","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{urlExternalAPI}}v2/city?city=Paris&state=Ile-de-France&country=France&key={{YOUR_API_KEY}}","host":["{{urlExternalAPI}}v2"],"path":["city"],"query":[{"key":"city","value":"Paris"},{"key":"state","value":"Ile-de-France"},{"key":"country","value":"France"},{"key":"key","value":"{{YOUR_API_KEY}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Cache-Control","value":"no-store","description":""},{"key":"Connection","value":"keep-alive","description":""},{"key":"Content-Encoding","value":"gzip","description":""},{"key":"Content-Type","value":"application/json","description":""},{"key":"Date","value":"Fri, 15 Sep 2017 10:19:27 GMT","description":""},{"key":"Pragma","value":"no-cache","description":""},{"key":"Server","value":"nginx/1.13.5","description":""},{"key":"Transfer-Encoding","value":"chunked","description":""},{"key":"Vary","value":"Accept-Encoding","description":""},{"key":"Via","value":"1.1 iqr-sg011-hk-hkg-1 (squid)","description":""},{"key":"X-Cache","value":"MISS from iqr-sg011-hk-hkg-1","description":""},{"key":"access-control-allow-headers","value":"Origin, X-Requested-With, Content-Type, Accept","description":""},{"key":"access-control-allow-origin","value":"*","description":""}],"cookie":[],"responseTime":"158","body":"{\n \"status\": \"success\",\n \"data\": {\n \"city\": \"Paris\",\n \"state\": \"Ile-de-France\",\n \"country\": \"France\",\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": [\n 2.351666,\n 48.859425\n ]\n },\n \"current\": {\n \"pollution\": {\n \"ts\": \"2025-09-08T08:00:00.000Z\",\n \"aqius\": 28,\n \"mainus\": \"p2\",\n \"aqicn\": 12,\n \"maincn\": \"o3\"\n },\n \"weather\": {\n \"ts\": \"2025-09-08T08:00:00.000Z\",\n \"ic\": \"03d\",\n \"hu\": 77,\n \"pr\": 1018,\n \"tp\": 17,\n \"wd\": 285,\n \"ws\": 2.5,\n \"heatIndex\": 17\n }\n }\n }\n}"}],"_postman_id":"5bc93d6b-d563-43dc-adb9-c266b2e96d4a"}],"id":"f6cadcfb-1522-40a3-8d38-1b98a92faf0c","_postman_id":"f6cadcfb-1522-40a3-8d38-1b98a92faf0c","description":""},{"name":"Startup","item":[{"name":"List supported stations in a city","event":[{"listen":"test","script":{"type":"text/javascript","exec":["tests[\"Status code is 200\"] = responseCode.code === 200;","","var jsonData = JSON.parse(responseBody).data;","tests[\"List is not empty\"] = jsonData.length !== 0;"]}}],"id":"57ee8c4c-07bc-4288-baaa-90caf0a8c780","request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"{{urlExternalAPI}}v2/stations?city={{CITY_NAME}}&state={{STATE_NAME}}&country={{COUNTRY_NAME}}&key={{YOUR_API_KEY}}","description":"

Return an array of all supported active stations, inside a specified city.

Each station object contains its English name station (requested by other endpoints)

Parameters

city: city's English name, can be found using the respective listing endpoint.
state: state's English name, can be found using the respective listing endpoint.
country: country's English name, can be found using the respective listing endpoint.

\n","urlObject":{"path":["stations"],"host":["{{urlExternalAPI}}v2"],"query":[{"key":"city","value":"{{CITY_NAME}}"},{"key":"state","value":"{{STATE_NAME}}"},{"key":"country","value":"{{COUNTRY_NAME}}"},{"key":"key","value":"{{YOUR_API_KEY}}"}],"variable":[]}},"response":[{"id":"08053560-7ba8-4c26-bf0e-c8b3ac703648","name":"Beijing, China","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":{"raw":"{{urlExternalAPI}}v2/stations?city=Beijing&state=Beijing&country=China&key={{YOUR_API_KEY}}","host":["{{urlExternalAPI}}v2"],"path":["stations"],"query":[{"key":"city","value":"Beijing"},{"key":"state","value":"Beijing"},{"key":"country","value":"China"},{"key":"key","value":"{{YOUR_API_KEY}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"name":"Cache-Control","key":"Cache-Control","value":"no-store","description":""},{"name":"Connection","key":"Connection","value":"keep-alive","description":""},{"name":"Content-Encoding","key":"Content-Encoding","value":"gzip","description":""},{"name":"Content-Type","key":"Content-Type","value":"application/json","description":""},{"name":"Date","key":"Date","value":"Fri, 15 Sep 2017 10:22:12 GMT","description":""},{"name":"Pragma","key":"Pragma","value":"no-cache","description":""},{"name":"Server","key":"Server","value":"nginx/1.13.5","description":""},{"name":"Transfer-Encoding","key":"Transfer-Encoding","value":"chunked","description":""},{"name":"Vary","key":"Vary","value":"Accept-Encoding","description":""},{"name":"Via","key":"Via","value":"1.1 iqr-sg011-hk-hkg-1 (squid)","description":""},{"name":"X-Cache","key":"X-Cache","value":"MISS from iqr-sg011-hk-hkg-1","description":""},{"name":"access-control-allow-headers","key":"access-control-allow-headers","value":"Origin, X-Requested-With, Content-Type, Accept","description":""},{"name":"access-control-allow-origin","key":"access-control-allow-origin","value":"*","description":""}],"cookie":[],"responseTime":"145","body":"{\"status\":\"success\",\"data\":[{\"location\":{\"type\":\"Point\",\"coordinates\":[116.466258,39.954352]},\"station\":\"US Embassy in Beijing\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.2148532181,40.0078007235]},\"station\":\"Botanical Garden\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.125765153,39.8577170565]},\"station\":\"Fengtai Yungang\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.326057,39.521301]},\"station\":\"Beijing south\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.796531,39.708782]},\"station\":\"Beijing south-east\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.405799162,39.8791255189]},\"station\":\"Yongdingmen\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.502085437,39.8032795971]},\"station\":\"Yizhuang BDA\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[115.991303372,40.4642478624]},\"station\":\"Yanqing\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.35976447,39.9474598264]},\"station\":\"Xizhimen north\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.368228,39.880064]},\"station\":\"Wanshou xigong\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.304101,39.968717]},\"station\":\"Haidian Wanliu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.69290509,39.92066923]},\"station\":\"Tongzhou new town\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.4065,39.8822]},\"station\":\"Temple of Heaven\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.640108,40.127]},\"station\":\"Shunyi\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.40020013,39.89949782]},\"station\":\"Qianmen\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[117.106847813,40.145932282]},\"station\":\"Pinggu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.462153,39.941674]},\"station\":\"Agricultural Exhibition Center\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.9255943,40.47688223]},\"station\":\"Miyun reservoir\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.8471279219,40.3746273634]},\"station\":\"Miyun\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.10666089,39.9363252761]},\"station\":\"Mentougou\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.033218,39.610654]},\"station\":\"Beijing south-west\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.640723,40.302266]},\"station\":\"Huairou\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.362934,39.932467]},\"station\":\"Guanyuan\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.191921,39.907467]},\"station\":\"GuCheng\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.291813087,39.8700811742]},\"station\":\"Fengtai garden\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[117.114127,40.10311]},\"station\":\"Beijing east\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.2321696,40.30111675]},\"station\":\"Ming Tombs\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.34060144,39.73874236]},\"station\":\"Daxing Huangcun\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.2269371,40.22866416]},\"station\":\"Changping\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.239677801,40.0331620451]},\"station\":\"Haidian new north area\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[115.99255458,40.36499159]},\"station\":\"Badaling\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.144102158,39.7387209791]},\"station\":\"Fangshan\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.393816,39.985682]},\"station\":\"Olympic Stadium\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[116.417,39.929]},\"station\":\"Dongsi\"}]}"},{"id":"3c13b0a6-e35d-4953-9f9b-41769f00cc56","name":"Seoul, South Korea","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":{"raw":"{{urlExternalAPI}}v2/stations?city=Seoul&state=Seoul&country=South Korea&key={{YOUR_API_KEY}}","host":["{{urlExternalAPI}}v2"],"path":["stations"],"query":[{"key":"city","value":"Seoul"},{"key":"state","value":"Seoul"},{"key":"country","value":"South Korea"},{"key":"key","value":"{{YOUR_API_KEY}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"name":"access-control-allow-headers","key":"access-control-allow-headers","value":"Origin, X-Requested-With, Content-Type, Accept","description":""},{"name":"access-control-allow-origin","key":"access-control-allow-origin","value":"*","description":""},{"name":"cache-control","key":"cache-control","value":"no-store","description":""},{"name":"connection","key":"connection","value":"keep-alive","description":""},{"name":"content-encoding","key":"content-encoding","value":"gzip","description":""},{"name":"content-type","key":"content-type","value":"application/json","description":""},{"name":"date","key":"date","value":"Fri, 15 Sep 2017 10:29:18 GMT","description":""},{"name":"pragma","key":"pragma","value":"no-cache","description":""},{"name":"transfer-encoding","key":"transfer-encoding","value":"chunked","description":""},{"name":"vary","key":"vary","value":"Accept-Encoding","description":""}],"cookie":[],"responseTime":"85","body":"{\"status\":\"success\",\"data\":[{\"location\":{\"type\":\"Point\",\"coordinates\":[126.998083,37.56865]},\"station\":\"Cheonggyecheon-ro\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.139172,37.534035]},\"station\":\"Cheonho-daero\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.029333,37.654278]},\"station\":\"Dobong-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.029642,37.576169]},\"station\":\"Dongdaemun-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[126.9832456,37.49210722]},\"station\":\"Dongjak-daero Jungangcharo\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[126.971547,37.480989]},\"station\":\"Dongjak-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.019694,37.516083]},\"station\":\"Dosan-daero\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[126.933144,37.610583]},\"station\":\"Eunpyeong-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.035621,37.482867]},\"station\":\"Gamnam-daero\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.029119,37.637903]},\"station\":\"Gangbuk-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[126.996783,37.570633]},\"station\":\"Gangbyeon\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.040943,37.539283]},\"station\":\"Gangbyeonbuk-ro\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.136806,37.545089]},\"station\":\"Gangdong-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.056558,37.496978]},\"station\":\"Gangnam-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[126.835094,37.544656]},\"station\":\"Gangseo-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[126.908333,37.452386]},\"station\":\"Geumcheon-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[126.8260717,37.56282167]},\"station\":\"Gonghang-daero\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[126.889692,37.498498]},\"station\":\"Guro-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[126.927089,37.488242]},\"station\":\"Gwanak-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.095706,37.544639]},\"station\":\"Gwangjin-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[126.971519,37.549389]},\"station\":\"Hangang-daero\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.044856,37.580167]},\"station\":\"Hongneung-ro\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.075319,37.617315]},\"station\":\"Hwarang-ro\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.0022,37.6077]},\"station\":\"Jeongneung-ro\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.005028,37.572025]},\"station\":\"Jongro-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[126.975961,37.564639]},\"station\":\"Jung-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.094283,37.584953]},\"station\":\"Jungnang-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[126.945167,37.550133]},\"station\":\"Mapo-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.067876,37.657415]},\"station\":\"Nowon-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[126.994611,37.504547]},\"station\":\"Seocho-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[126.937972,37.576578]},\"station\":\"Seodaemun-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.027264,37.606667]},\"station\":\"Seongbuk-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.041278,37.543106]},\"station\":\"Seongdong-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[126.937619,37.554936]},\"station\":\"Sinchon-ro\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.124264,37.521597]},\"station\":\"Songpa-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[126.858689,37.523286]},\"station\":\"Yangcheon-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[126.89737,37.525007]},\"station\":\"Yeongdeungpo-gu\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[126.904967,37.520222]},\"station\":\"Yeongdeungpo-ro\"},{\"location\":{\"type\":\"Point\",\"coordinates\":[127.005083,37.540314]},\"station\":\"Yongsan-gu\"}]}"}],"_postman_id":"57ee8c4c-07bc-4288-baaa-90caf0a8c780"},{"name":"Get nearest station data (IP geolocation)","event":[{"listen":"test","script":{"id":"5a4badf8-9bd7-47dc-b01d-5fb99e2870c5","exec":["tests[\"Status code is 200\"] = responseCode.code === 200;","","var jsonData = JSON.parse(responseBody).data;","tests[\"City field is not empty\"] = (jsonData.city && 0 !== jsonData.city.length);"],"type":"text/javascript"}}],"id":"a067e76a-483e-46ad-9e9f-bf4e3bcc0879","request":{"method":"GET","header":[{"key":"x-forwarded-for","value":"27.102.113.160","type":"text"}],"url":"{{urlExternalAPI}}v2/nearest_station?key={{YOUR_API_KEY}}","description":"

Return nearest station's data, using IP address geolocation.

Values returned in the object depends on you API plan, please refer to the API page on our website to check which values and level of detail your API plan allows you to access.

\n","urlObject":{"path":["nearest_station"],"host":["{{urlExternalAPI}}v2"],"query":[{"key":"key","value":"{{YOUR_API_KEY}}"}],"variable":[]}},"response":[{"id":"e79ce8ba-2f25-4596-9c6f-dccb59ad062d","name":"Seocho-gu, Seoul, Korea","originalRequest":{"method":"GET","header":[{"key":"x-forwarded-for","value":"27.102.113.160","type":"text"}],"url":{"raw":"{{urlExternalAPI}}v2/nearest_station?key={{YOUR_API_KEY}}","host":["{{urlExternalAPI}}v2"],"path":["nearest_station"],"query":[{"key":"key","value":"{{YOUR_API_KEY}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"access-control-allow-headers","value":"Origin, X-Requested-With, Content-Type, Accept","description":""},{"key":"access-control-allow-origin","value":"*","description":""},{"key":"cache-control","value":"no-store","description":""},{"key":"connection","value":"keep-alive","description":""},{"key":"content-encoding","value":"gzip","description":""},{"key":"content-type","value":"application/json","description":""},{"key":"date","value":"Fri, 15 Sep 2017 09:46:55 GMT","description":""},{"key":"pragma","value":"no-cache","description":""},{"key":"transfer-encoding","value":"chunked","description":""},{"key":"vary","value":"Accept-Encoding","description":""}],"cookie":[],"responseTime":"1558","body":"{\n \"status\": \"success\",\n \"data\": {\n \"name\": \"Seocho-gu\",\n \"city\": \"Seoul\",\n \"state\": \"Seoul\",\n \"country\": \"South Korea\",\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": [\n 126.994611,\n 37.504547\n ]\n },\n \"units\": {\n \"p2\": \"ugm3\",\n \"p1\": \"ugm3\",\n \"o3\": \"ugm3\",\n \"n2\": \"ugm3\",\n \"s2\": \"ugm3\",\n \"co\": \"ugm3\",\n \"pm25\": \"ugm3\",\n \"pm10\": \"ugm3\"\n },\n \"current\": {\n \"pollution\": {\n \"ts\": \"2025-09-08T08:00:00.000Z\",\n \"aqius\": 66,\n \"mainus\": \"o3\",\n \"aqicn\": 58,\n \"maincn\": \"o3\",\n \"p2\": {\n \"conc\": 12,\n \"aqius\": 56,\n \"aqicn\": 17\n },\n \"p1\": {\n \"conc\": 32,\n \"aqius\": 30,\n \"aqicn\": 32\n },\n \"o3\": {\n \"conc\": 166,\n \"aqius\": 66,\n \"aqicn\": 58\n },\n \"n2\": {\n \"conc\": 40,\n \"aqius\": 20,\n \"aqicn\": 20\n },\n \"s2\": {\n \"conc\": 7.6,\n \"aqius\": 3,\n \"aqicn\": 8\n },\n \"co\": {\n \"conc\": 561.1,\n \"aqius\": 5,\n \"aqicn\": 6\n }\n },\n \"weather\": {\n \"ts\": \"2025-09-08T08:00:00.000Z\",\n \"ic\": \"04d\",\n \"hu\": 61,\n \"pr\": 1010,\n \"tp\": 26,\n \"wd\": 275,\n \"ws\": 3.68,\n \"heatIndex\": 26\n }\n }\n }\n}"}],"_postman_id":"a067e76a-483e-46ad-9e9f-bf4e3bcc0879"},{"name":"Get nearest station data (GPS coodinates)","event":[{"listen":"test","script":{"id":"2f6b8783-dfb7-4ccc-b588-ade30ec05374","exec":["tests[\"Status code is 200\"] = responseCode.code === 200;","","","var jsonData = JSON.parse(responseBody).data;","tests[\"City field is not empty\"] = (jsonData.city && 0 !== jsonData.city.length);"],"type":"text/javascript"}}],"id":"fe3a4e79-c63c-45b2-9627-7deddc4cc7a6","request":{"method":"GET","header":[],"url":"{{urlExternalAPI}}v2/nearest_station?lat={{LATITUDE}}&lon={{LONGITUDE}}&key={{YOUR_API_KEY}}","description":"

Return nearest station's data, using a specified set of GPS coordinates.

Values returned in the object depends on you API plan, please refer to the API page on our website to check which values and level of detail your API plan allows you to access.

Parameters

lat: Latitude numerical value, within range [-90, 90].
lon: Longitude numerical value, within range [-180, 180].

\n","urlObject":{"path":["nearest_station"],"host":["{{urlExternalAPI}}v2"],"query":[{"key":"lat","value":"{{LATITUDE}}"},{"key":"lon","value":"{{LONGITUDE}}"},{"key":"key","value":"{{YOUR_API_KEY}}"}],"variable":[]}},"response":[{"id":"dc9c7dda-0bb2-4e49-9c32-6f267fc19966","name":"St. John's, Mount Pearl, Canada","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{urlExternalAPI}}v2/nearest_station?lat=48.02&lon=-50.20&key={{YOUR_API_KEY}}","host":["{{urlExternalAPI}}v2"],"path":["nearest_station"],"query":[{"key":"lat","value":"48.02"},{"key":"lon","value":"-50.20"},{"key":"key","value":"{{YOUR_API_KEY}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"access-control-allow-headers","value":"Origin, X-Requested-With, Content-Type, Accept","description":""},{"key":"access-control-allow-origin","value":"*","description":""},{"key":"cache-control","value":"no-store","description":""},{"key":"connection","value":"keep-alive","description":""},{"key":"content-encoding","value":"gzip","description":""},{"key":"content-type","value":"application/json","description":""},{"key":"date","value":"Fri, 15 Sep 2017 10:30:53 GMT","description":""},{"key":"pragma","value":"no-cache","description":""},{"key":"transfer-encoding","value":"chunked","description":""},{"key":"vary","value":"Accept-Encoding","description":""}],"cookie":[],"responseTime":"60","body":"{\n \"status\": \"success\",\n \"data\": {\n \"name\": \"St. John's\",\n \"city\": \"Mount Pearl\",\n \"state\": \"Newfoundland and Labrador\",\n \"country\": \"Canada\",\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": [\n -52.7115,\n 47.56038\n ]\n },\n \"units\": {\n \"p2\": \"ugm3\",\n \"p1\": \"ugm3\",\n \"o3\": \"ugm3\",\n \"n2\": \"ugm3\",\n \"s2\": \"ugm3\",\n \"co\": \"ugm3\",\n \"pm25\": \"ugm3\",\n \"pm10\": \"ugm3\"\n },\n \"current\": {\n \"pollution\": {\n \"ts\": \"2025-09-08T07:00:00.000Z\",\n \"aqius\": 7,\n \"mainus\": \"p2\",\n \"aqicn\": 6,\n \"maincn\": \"o3\",\n \"p2\": {\n \"conc\": 1.3,\n \"aqius\": 7,\n \"aqicn\": 2\n },\n \"p1\": {\n \"conc\": 3.8,\n \"aqius\": 3,\n \"aqicn\": 4\n },\n \"o3\": {\n \"conc\": 18.4,\n \"aqius\": 7,\n \"aqicn\": 6\n }\n },\n \"weather\": {\n \"ts\": \"2025-09-08T08:00:00.000Z\",\n \"ic\": \"04n\",\n \"hu\": 97,\n \"pr\": 1016,\n \"tp\": 18,\n \"wd\": 225,\n \"ws\": 6.78,\n \"heatIndex\": 18\n }\n }\n }\n}"}],"_postman_id":"fe3a4e79-c63c-45b2-9627-7deddc4cc7a6"},{"name":"Get specified station data","event":[{"listen":"test","script":{"type":"text/javascript","exec":["tests[\"Status code is 200\"] = responseCode.code === 200;","","","","var jsonData = JSON.parse(responseBody).data;","tests[\"City field is not empty\"] = (jsonData.city && 0 !== jsonData.city.length);"]}}],"id":"005b1483-28c9-495e-9d84-03567a1c8100","request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"{{urlExternalAPI}}v2/station?station={{STATION_NAME}}&city={{CITY_NAME}}&state={{STATE_NAME}}&country={{COUNTRY_NAME}}&key={{YOUR_API_KEY}}","description":"

Return specified city's data object.

Values returned in the object depends on you API plan, please refer to the API page on our website to check which values and level of detail your API plan allows you to access.

Parameters

station: station's English name, can be found using the respective listing endpoint.
city: city's English name, can be found using the respective listing endpoint.
state: state's English name, can be found using the respective listing endpoint.
country: country's English name, can be found using the respective listing endpoint.

\n","urlObject":{"path":["station"],"host":["{{urlExternalAPI}}v2"],"query":[{"key":"station","value":"{{STATION_NAME}}"},{"key":"city","value":"{{CITY_NAME}}"},{"key":"state","value":"{{STATE_NAME}}"},{"key":"country","value":"{{COUNTRY_NAME}}"},{"key":"key","value":"{{YOUR_API_KEY}}"}],"variable":[]}},"response":[{"id":"76175299-34e0-4579-9398-89213ba217bd","name":"Gangnam, Seoul, Korea","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{urlExternalAPI}}v2/station?station=Gangnam-gu&city=Seoul&state=Seoul&country=South Korea&key={{YOUR_API_KEY}}","host":["{{urlExternalAPI}}v2"],"path":["station"],"query":[{"key":"station","value":"Gangnam-gu"},{"key":"city","value":"Seoul"},{"key":"state","value":"Seoul"},{"key":"country","value":"South Korea"},{"key":"key","value":"{{YOUR_API_KEY}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"access-control-allow-headers","value":"Origin, X-Requested-With, Content-Type, Accept","description":""},{"key":"access-control-allow-origin","value":"*","description":""},{"key":"cache-control","value":"no-store","description":""},{"key":"connection","value":"keep-alive","description":""},{"key":"content-encoding","value":"gzip","description":""},{"key":"content-type","value":"application/json","description":""},{"key":"date","value":"Fri, 15 Sep 2017 10:33:53 GMT","description":""},{"key":"pragma","value":"no-cache","description":""},{"key":"transfer-encoding","value":"chunked","description":""},{"key":"vary","value":"Accept-Encoding","description":""}],"cookie":[],"responseTime":"32","body":"{\n \"status\": \"success\",\n \"data\": {\n \"name\": \"Gangnam-gu\",\n \"city\": \"Seoul\",\n \"state\": \"Seoul\",\n \"country\": \"South Korea\",\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": [\n 127.0472893,\n 37.5175623\n ]\n },\n \"units\": {\n \"p2\": \"ugm3\",\n \"p1\": \"ugm3\",\n \"o3\": \"ugm3\",\n \"n2\": \"ugm3\",\n \"s2\": \"ugm3\",\n \"co\": \"ugm3\",\n \"pm25\": \"ugm3\",\n \"pm10\": \"ugm3\"\n },\n \"current\": {\n \"pollution\": {\n \"ts\": \"2025-09-08T08:00:00.000Z\",\n \"aqius\": 64,\n \"mainus\": \"p2\",\n \"aqicn\": 48,\n \"maincn\": \"o3\",\n \"p2\": {\n \"conc\": 16,\n \"aqius\": 64,\n \"aqicn\": 23\n },\n \"p1\": {\n \"conc\": 32,\n \"aqius\": 30,\n \"aqicn\": 32\n },\n \"o3\": {\n \"conc\": 152.8,\n \"aqius\": 61,\n \"aqicn\": 48\n },\n \"n2\": {\n \"conc\": 34,\n \"aqius\": 17,\n \"aqicn\": 17\n },\n \"s2\": {\n \"conc\": 6.3,\n \"aqius\": 3,\n \"aqicn\": 6\n },\n \"co\": {\n \"conc\": 492.4,\n \"aqius\": 5,\n \"aqicn\": 5\n }\n },\n \"weather\": {\n \"ts\": \"2025-09-08T08:00:00.000Z\",\n \"ic\": \"04d\",\n \"hu\": 61,\n \"pr\": 1010,\n \"tp\": 26,\n \"wd\": 274,\n \"ws\": 3.34,\n \"heatIndex\": 26\n }\n }\n }\n}"}],"_postman_id":"005b1483-28c9-495e-9d84-03567a1c8100"},{"name":"Get specified city data","event":[{"listen":"test","script":{"id":"b4996b50-f12e-4077-ac48-df4206cb8892","exec":["tests[\"Status code is 200\"] = responseCode.code === 200;","","","","var jsonData = JSON.parse(responseBody).data;","tests[\"City field is not empty\"] = (jsonData.city && 0 !== jsonData.city.length);"],"type":"text/javascript","packages":{}}}],"id":"b3690bd9-6fb0-439e-a675-2536a88568d4","request":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":"{{urlExternalAPI}}v2/city?city={{CITY_NAME}}&state={{STATE_NAME}}&country={{COUNTRY_NAME}}&key={{YOUR_API_KEY}}","description":"

Return specified city's data object.

Values returned in the object depends on you API plan, please refer to the API page on our website to check which values and level of detail your API plan allows you to access.

Parameters

station: station's English name, can be found using the respective listing endpoint.
\n
city: city's English name, can be found using the respective listing endpoint.
\n
state: state's English name, can be found using the respective listing endpoint.
\n
country: country's English name, can be found using the respective listing endpoint.
\n

\n","urlObject":{"path":["city"],"host":["{{urlExternalAPI}}v2"],"query":[{"key":"city","value":"{{CITY_NAME}}"},{"key":"state","value":"{{STATE_NAME}}"},{"key":"country","value":"{{COUNTRY_NAME}}"},{"key":"key","value":"{{YOUR_API_KEY}}"}],"variable":[]}},"response":[{"id":"3ed99c46-f058-4e2d-86a8-cde9da5201c2","name":"Beijing, China","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{urlExternalAPI}}v2/city?city=Beijing&state=Beijing&country=China&key={{YOUR_API_KEY}}","host":["{{urlExternalAPI}}v2"],"path":["city"],"query":[{"key":"city","value":"Beijing"},{"key":"state","value":"Beijing"},{"key":"country","value":"China"},{"key":"key","value":"{{YOUR_API_KEY}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"access-control-allow-headers","value":"Origin, X-Requested-With, Content-Type, Accept","description":""},{"key":"access-control-allow-origin","value":"*","description":""},{"key":"cache-control","value":"no-store","description":""},{"key":"connection","value":"keep-alive","description":""},{"key":"content-encoding","value":"gzip","description":""},{"key":"content-type","value":"application/json","description":""},{"key":"date","value":"Fri, 15 Sep 2017 09:46:35 GMT","description":""},{"key":"pragma","value":"no-cache","description":""},{"key":"transfer-encoding","value":"chunked","description":""},{"key":"vary","value":"Accept-Encoding","description":""}],"cookie":[],"responseTime":"24","body":"{\n \"status\": \"success\",\n \"data\": {\n \"city\": \"Beijing\",\n \"state\": \"Beijing\",\n \"country\": \"China\",\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": [\n 116.462153,\n 39.941674\n ]\n },\n \"current\": {\n \"pollution\": {\n \"ts\": \"2025-09-08T08:00:00.000Z\",\n \"aqius\": 57,\n \"mainus\": \"o3\",\n \"aqicn\": 44,\n \"maincn\": \"o3\",\n \"p2\": {\n \"conc\": 9,\n \"aqius\": 50,\n \"aqicn\": 13\n },\n \"p1\": {\n \"conc\": 28,\n \"aqius\": 26,\n \"aqicn\": 28\n },\n \"o3\": {\n \"conc\": 140,\n \"aqius\": 57,\n \"aqicn\": 44\n },\n \"n2\": {\n \"conc\": 10,\n \"aqius\": 5,\n \"aqicn\": 5\n },\n \"s2\": {\n \"conc\": 3,\n \"aqius\": 1,\n \"aqicn\": 3\n },\n \"co\": {\n \"conc\": 300,\n \"aqius\": 3,\n \"aqicn\": 3\n }\n },\n \"weather\": {\n \"ts\": \"2025-09-08T08:00:00.000Z\",\n \"ic\": \"01d\",\n \"hu\": 30,\n \"pr\": 1008,\n \"tp\": 31,\n \"wd\": 178,\n \"ws\": 4.54,\n \"heatIndex\": 30\n }\n },\n \"units\": {\n \"p2\": \"ugm3\",\n \"p1\": \"ugm3\",\n \"o3\": \"ugm3\",\n \"n2\": \"ugm3\",\n \"s2\": \"ugm3\",\n \"co\": \"ugm3\",\n \"pm25\": \"ugm3\",\n \"pm10\": \"ugm3\"\n }\n }\n}"},{"id":"c8861178-e393-40f6-86fd-9f22abd6414e","name":"Seoul, Korea","originalRequest":{"method":"GET","header":[],"url":{"raw":"{{urlExternalAPI}}v2/city?city=Seoul&state=Seoul&country=South Korea&key={{YOUR_API_KEY}}","host":["{{urlExternalAPI}}v2"],"path":["city"],"query":[{"key":"city","value":"Seoul"},{"key":"state","value":"Seoul"},{"key":"country","value":"South Korea"},{"key":"key","value":"{{YOUR_API_KEY}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"access-control-allow-headers","value":"Origin, X-Requested-With, Content-Type, Accept","description":""},{"key":"access-control-allow-origin","value":"*","description":""},{"key":"cache-control","value":"no-store","description":""},{"key":"connection","value":"keep-alive","description":""},{"key":"content-encoding","value":"gzip","description":""},{"key":"content-type","value":"application/json","description":""},{"key":"date","value":"Fri, 15 Sep 2017 10:33:53 GMT","description":""},{"key":"pragma","value":"no-cache","description":""},{"key":"transfer-encoding","value":"chunked","description":""},{"key":"vary","value":"Accept-Encoding","description":""}],"cookie":[],"responseTime":"32","body":"{\n \"status\": \"success\",\n \"data\": {\n \"city\": \"Seoul\",\n \"state\": \"Seoul\",\n \"country\": \"South Korea\",\n \"location\": {\n \"type\": \"Point\",\n \"coordinates\": [\n 126.975961,\n 37.564639\n ]\n },\n \"current\": {\n \"pollution\": {\n \"ts\": \"2025-09-08T08:00:00.000Z\",\n \"aqius\": 64,\n \"mainus\": \"p2\",\n \"aqicn\": 46,\n \"maincn\": \"o3\",\n \"p2\": {\n \"conc\": 16,\n \"aqius\": 64,\n \"aqicn\": 23\n },\n \"p1\": {\n \"conc\": 32,\n \"aqius\": 30,\n \"aqicn\": 32\n },\n \"o3\": {\n \"conc\": 147.7,\n \"aqius\": 60,\n \"aqicn\": 46\n },\n \"n2\": {\n \"conc\": 28.8,\n \"aqius\": 14,\n \"aqicn\": 14\n },\n \"s2\": {\n \"conc\": 7.3,\n \"aqius\": 3,\n \"aqicn\": 7\n },\n \"co\": {\n \"conc\": 492.4,\n \"aqius\": 5,\n \"aqicn\": 5\n }\n },\n \"weather\": {\n \"ts\": \"2025-09-08T08:00:00.000Z\",\n \"ic\": \"04d\",\n \"hu\": 60,\n \"pr\": 1010,\n \"tp\": 26,\n \"wd\": 281,\n \"ws\": 3.36,\n \"heatIndex\": 26\n }\n },\n \"units\": {\n \"p2\": \"ugm3\",\n \"p1\": \"ugm3\",\n \"o3\": \"ugm3\",\n \"n2\": \"ugm3\",\n \"s2\": \"ugm3\",\n \"co\": \"ugm3\",\n \"pm25\": \"ugm3\",\n \"pm10\": \"ugm3\"\n }\n }\n}"}],"_postman_id":"b3690bd9-6fb0-439e-a675-2536a88568d4"}],"id":"2198899b-9e06-470c-a59e-6682b08469ef","_postman_id":"2198899b-9e06-470c-a59e-6682b08469ef","description":""},{"name":"Enterprise","item":[{"name":"Get global city ranking","event":[{"listen":"test","script":{"id":"c5e519e0-1379-440a-933b-a9aa61e075c8","exec":["tests[\"Status code is 200\"] = responseCode.code === 200;","","var jsonData = JSON.parse(responseBody).data;","tests[\"List is not empty\"] = jsonData.length !== 0;"],"type":"text/javascript","packages":{}}}],"id":"98aa093c-2224-4e42-a589-b37ecbbb1aa3","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[],"url":"{{urlExternalAPI}}v2/city_ranking?key={{YOUR_API_KEY}}&sort=&country={{COUNTRY_NAME}}","description":"

Return a sorted array (highest to lowest AQI) of selected major cities in the world.

For each city you will receive its current AQI, in US and Chinese standard.

\n","urlObject":{"path":["city_ranking"],"host":["{{urlExternalAPI}}v2"],"query":[{"key":"key","value":"{{YOUR_API_KEY}}"},{"description":{"content":"

Sort cities by air quality value:

asc = Sort by cleanest cities

desc = Sort by most pollutet cities ( default value )

\n","type":"text/plain"},"key":"sort","value":""},{"description":{"content":"

Filter cities by country ( Optional )

Allowed values: Thailand | USA | Canada

If empty or invalid value will return all cities

\n","type":"text/plain"},"key":"country","value":"{{COUNTRY_NAME}}"}],"variable":[]}},"response":[{"id":"44b63c77-35c3-4892-83c9-74951f7ef550","name":"All","originalRequest":{"method":"GET","header":[],"body":{"mode":"formdata","formdata":[]},"url":{"raw":"{{urlExternalAPI}}v2/city_ranking?key={{YOUR_API_KEY}}","host":["{{urlExternalAPI}}v2"],"path":["city_ranking"],"query":[{"key":"key","value":"{{YOUR_API_KEY}}"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"name":"access-control-allow-headers","key":"access-control-allow-headers","value":"Origin, X-Requested-With, Content-Type, Accept","description":""},{"name":"access-control-allow-origin","key":"access-control-allow-origin","value":"*","description":""},{"name":"cache-control","key":"cache-control","value":"no-store","description":""},{"name":"connection","key":"connection","value":"keep-alive","description":""},{"name":"content-encoding","key":"content-encoding","value":"gzip","description":""},{"name":"content-type","key":"content-type","value":"application/json","description":""},{"name":"date","key":"date","value":"Fri, 15 Sep 2017 10:34:40 GMT","description":""},{"name":"pragma","key":"pragma","value":"no-cache","description":""},{"name":"transfer-encoding","key":"transfer-encoding","value":"chunked","description":""},{"name":"vary","key":"vary","value":"Accept-Encoding","description":""}],"cookie":[],"responseTime":"49","body":"{\"status\":\"success\",\"data\":[{\"city\":\"Portland\",\"state\":\"Oregon\",\"country\":\"USA\",\"ranking\":{\"current_aqi\":183,\"current_aqi_cn\":154}},{\"city\":\"Eugene\",\"state\":\"Oregon\",\"country\":\"USA\",\"ranking\":{\"current_aqi\":151,\"current_aqi_cn\":77}},{\"city\":\"Dhaka\",\"state\":\"Dhaka\",\"country\":\"Bangladesh\",\"ranking\":{\"current_aqi\":141,\"current_aqi_cn\":71}},{\"city\":\"Mumbai\",\"state\":\"Maharashtra\",\"country\":\"India\",\"ranking\":{\"current_aqi\":129,\"current_aqi_cn\":65}},{\"city\":\"Jakarta\",\"state\":\"Jakarta\",\"country\":\"Indonesia\",\"ranking\":{\"current_aqi\":121,\"current_aqi_cn\":61}},{\"city\":\"Brasov\",\"state\":\"Centru\",\"country\":\"Romania\",\"ranking\":{\"current_aqi\":118,\"current_aqi_cn\":59,\"last_aqi\":140,\"last_aqi_cn\":71}},{\"city\":\"Chiang Mai\",\"state\":\"Chiang Mai\",\"country\":\"Thailand\",\"ranking\":{\"current_aqi\":114,\"current_aqi_cn\":58}},{\"city\":\"Santiago\",\"state\":\"Santiago Metropolitan\",\"country\":\"Chile\",\"ranking\":{\"current_aqi\":109,\"current_aqi_cn\":55}},{\"city\":\"Taipei\",\"state\":\"Taipei\",\"country\":\"Taiwan\",\"ranking\":{\"current_aqi\":100,\"current_aqi_cn\":50}},{\"city\":\"Kolkata\",\"state\":\"West Bengal\",\"country\":\"India\",\"ranking\":{\"current_aqi\":98,\"current_aqi_cn\":49}},{\"city\":\"Seattle\",\"state\":\"Washington\",\"country\":\"USA\",\"ranking\":{\"current_aqi\":94,\"current_aqi_cn\":46}},{\"city\":\"Beijing\",\"state\":\"Beijing\",\"country\":\"China\",\"ranking\":{\"current_aqi\":90,\"current_aqi_cn\":44}},{\"city\":\"Sao Paulo\",\"state\":\"Sao Paulo\",\"country\":\"Brazil\",\"ranking\":{\"current_aqi\":89,\"current_aqi_cn\":43}},{\"city\":\"Lahore\",\"state\":\"Punjab\",\"country\":\"Pakistan\",\"ranking\":{\"current_aqi\":88,\"current_aqi_cn\":43}},{\"city\":\"Osaka\",\"state\":\"Osaka\",\"country\":\"Japan\",\"ranking\":{\"current_aqi\":84,\"current_aqi_cn\":40}},{\"city\":\"Guangzhou\",\"state\":\"Guangdong\",\"country\":\"China\",\"ranking\":{\"current_aqi\":83,\"current_aqi_cn\":39}},{\"city\":\"Port Harcourt\",\"state\":\"Rivers\",\"country\":\"Nigeria\",\"ranking\":{\"current_aqi\":83,\"current_aqi_cn\":39,\"last_aqi\":96,\"last_aqi_cn\":48}},{\"city\":\"Hanoi\",\"state\":\"Hanoi\",\"country\":\"Vietnam\",\"ranking\":{\"current_aqi\":80,\"current_aqi_cn\":37}},{\"city\":\"Lima\",\"state\":\"Lima\",\"country\":\"Peru\",\"ranking\":{\"current_aqi\":80,\"current_aqi_cn\":37}},{\"city\":\"Chengdu\",\"state\":\"Sichuan\",\"country\":\"China\",\"ranking\":{\"current_aqi\":79,\"current_aqi_cn\":36}},{\"city\":\"Bogota\",\"state\":\"Bogota\",\"country\":\"Colombia\",\"ranking\":{\"current_aqi\":76,\"current_aqi_cn\":34}},{\"city\":\"Seoul\",\"state\":\"Seoul\",\"country\":\"South Korea\",\"ranking\":{\"current_aqi\":76,\"current_aqi_cn\":34}},{\"city\":\"Paris\",\"state\":\"Ile-de-France\",\"country\":\"France\",\"ranking\":{\"current_aqi\":75,\"current_aqi_cn\":33}},{\"city\":\"Riyadh\",\"state\":\"Riyadh\",\"country\":\"Saudi Arabia\",\"ranking\":{\"current_aqi\":74,\"current_aqi_cn\":33,\"last_aqi\":85,\"last_aqi_cn\":40}},{\"city\":\"Wroclaw\",\"state\":\"Wroclaw\",\"country\":\"Poland\",\"ranking\":{\"current_aqi\":71,\"current_aqi_cn\":31}},{\"city\":\"Denver\",\"state\":\"Colorado\",\"country\":\"USA\",\"ranking\":{\"current_aqi\":70,\"current_aqi_cn\":30}},{\"city\":\"Tehran\",\"state\":\"Tehran\",\"country\":\"Iran\",\"ranking\":{\"current_aqi\":69,\"current_aqi_cn\":30}},{\"city\":\"Kuala Lumpur\",\"state\":\"Wilayah Persekutuan\",\"country\":\"Malaysia\",\"ranking\":{\"current_aqi\":69,\"current_aqi_cn\":30,\"last_aqi\":70,\"last_aqi_cn\":30}},{\"city\":\"Oakland\",\"state\":\"California\",\"country\":\"USA\",\"ranking\":{\"current_aqi\":63,\"current_aqi_cn\":26}},{\"city\":\"Incheon\",\"state\":\"Gyeonggi-do\",\"country\":\"South Korea\",\"ranking\":{\"current_aqi\":63,\"current_aqi_cn\":25}},{\"city\":\"Sacramento\",\"state\":\"California\",\"country\":\"USA\",\"ranking\":{\"current_aqi\":61,\"current_aqi_cn\":24}},{\"city\":\"Los Angeles\",\"state\":\"California\",\"country\":\"USA\",\"ranking\":{\"current_aqi\":59,\"current_aqi_cn\":23}},{\"city\":\"Busan\",\"state\":\"Gyeongsangnam-do\",\"country\":\"South Korea\",\"ranking\":{\"current_aqi\":59,\"current_aqi_cn\":23}},{\"city\":\"Hong Kong\",\"state\":\"Hong Kong\",\"country\":\"China\",\"ranking\":{\"current_aqi\":58,\"current_aqi_cn\":22}},{\"city\":\"San Francisco\",\"state\":\"California\",\"country\":\"USA\",\"ranking\":{\"current_aqi\":58,\"current_aqi_cn\":22}},{\"city\":\"Nice\",\"state\":\"PACA\",\"country\":\"France\",\"ranking\":{\"current_aqi\":57,\"current_aqi_cn\":21}},{\"city\":\"Shanghai\",\"state\":\"Shanghai\",\"country\":\"China\",\"ranking\":{\"current_aqi\":55,\"current_aqi_cn\":20}},{\"city\":\"Karachi\",\"state\":\"Sindh\",\"country\":\"Pakistan\",\"ranking\":{\"current_aqi\":55,\"current_aqi_cn\":20,\"last_aqi\":55,\"last_aqi_cn\":20}},{\"city\":\"Tel Aviv-Yafo\",\"state\":\"Tel Aviv District\",\"country\":\"Israel\",\"ranking\":{\"current_aqi\":54,\"current_aqi_cn\":20}},{\"city\":\"Krakow\",\"state\":\"krakow\",\"country\":\"Poland\",\"ranking\":{\"current_aqi\":51,\"current_aqi_cn\":17}},{\"city\":\"London\",\"state\":\"Greater London\",\"country\":\"United Kingdom\",\"ranking\":{\"current_aqi\":51,\"current_aqi_cn\":17}},{\"city\":\"Pristina\",\"state\":\"Kosovo\",\"country\":\"Kosovo\",\"ranking\":{\"current_aqi\":50,\"current_aqi_cn\":17}},{\"city\":\"Bakersfield\",\"state\":\"California\",\"country\":\"USA\",\"ranking\":{\"current_aqi\":50,\"current_aqi_cn\":17}},{\"city\":\"Newark\",\"state\":\"New Jersey\",\"country\":\"USA\",\"ranking\":{\"current_aqi\":49,\"current_aqi_cn\":17}},{\"city\":\"Warsaw\",\"state\":\"Mazowieckie\",\"country\":\"Poland\",\"ranking\":{\"current_aqi\":49,\"current_aqi_cn\":17}},{\"city\":\"Poznan\",\"state\":\"Poznan\",\"country\":\"Poland\",\"ranking\":{\"current_aqi\":49,\"current_aqi_cn\":17}},{\"city\":\"Kaohsiung\",\"state\":\"Kaohsiung\",\"country\":\"Taiwan\",\"ranking\":{\"current_aqi\":46,\"current_aqi_cn\":16}},{\"city\":\"Singapore\",\"state\":\"Singapore\",\"country\":\"Singapore\",\"ranking\":{\"current_aqi\":45,\"current_aqi_cn\":16}},{\"city\":\"Kosice\",\"state\":\"Kosice\",\"country\":\"Slovakia\",\"ranking\":{\"current_aqi\":45,\"current_aqi_cn\":16}},{\"city\":\"Bangkok\",\"state\":\"Bangkok\",\"country\":\"Thailand\",\"ranking\":{\"current_aqi\":44,\"current_aqi_cn\":15}},{\"city\":\"Manila\",\"state\":\"National Capital Region\",\"country\":\"Philippines\",\"ranking\":{\"current_aqi\":43,\"current_aqi_cn\":15}},{\"city\":\"Escaldes-Engordany\",\"state\":\"andorra\",\"country\":\"Andorra\",\"ranking\":{\"current_aqi\":43,\"current_aqi_cn\":33,\"last_aqi\":47,\"last_aqi_cn\":36}},{\"city\":\"Munich\",\"state\":\"Bavaria\",\"country\":\"Germany\",\"ranking\":{\"current_aqi\":35,\"current_aqi_cn\":27,\"last_aqi\":44,\"last_aqi_cn\":33}},{\"city\":\"Brussels\",\"state\":\"Brussels\",\"country\":\"Belgium\",\"ranking\":{\"current_aqi\":33,\"current_aqi_cn\":11}},{\"city\":\"Budapest\",\"state\":\"Central Hungary\",\"country\":\"Hungary\",\"ranking\":{\"current_aqi\":33,\"current_aqi_cn\":43,\"last_aqi\":30,\"last_aqi_cn\":43}},{\"city\":\"Vilnius\",\"state\":\"Vilniaus apskritis\",\"country\":\"Lithuania\",\"ranking\":{\"current_aqi\":33,\"current_aqi_cn\":11}},{\"city\":\"Madrid\",\"state\":\"Madrid\",\"country\":\"Spain\",\"ranking\":{\"current_aqi\":29,\"current_aqi_cn\":10}},{\"city\":\"Amsterdam\",\"state\":\"Noord-Holland\",\"country\":\"Netherlands\",\"ranking\":{\"current_aqi\":26,\"current_aqi_cn\":9}},{\"city\":\"Toronto Downtown\",\"state\":\"Ontario\",\"country\":\"Canada\",\"ranking\":{\"current_aqi\":25,\"current_aqi_cn\":9}},{\"city\":\"Prague\",\"state\":\"Prague\",\"country\":\"Czech Republic\",\"ranking\":{\"current_aqi\":23,\"current_aqi_cn\":8}},{\"city\":\"Moscow\",\"state\":\"Moscow\",\"country\":\"Russia\",\"ranking\":{\"current_aqi\":22,\"current_aqi_cn\":8}},{\"city\":\"Lisbon\",\"state\":\"Lisbon\",\"country\":\"Portugal\",\"ranking\":{\"current_aqi\":21,\"current_aqi_cn\":7}},{\"city\":\"Bratislava\",\"state\":\"Bratislava\",\"country\":\"Slovakia\",\"ranking\":{\"current_aqi\":20,\"current_aqi_cn\":22,\"last_aqi\":14,\"last_aqi_cn\":15}},{\"city\":\"Ulaanbaatar\",\"state\":\"Ulaanbaatar\",\"country\":\"Mongolia\",\"ranking\":{\"current_aqi\":19,\"current_aqi_cn\":7}},{\"city\":\"Detroit\",\"state\":\"Michigan\",\"country\":\"USA\",\"ranking\":{\"current_aqi\":19,\"current_aqi_cn\":7}},{\"city\":\"Phnom Penh\",\"state\":\"Phnom Penh\",\"country\":\"Cambodia\",\"ranking\":{\"current_aqi\":19,\"current_aqi_cn\":6,\"last_aqi\":20,\"last_aqi_cn\":7}},{\"city\":\"Jerusalem\",\"state\":\"Jerusalem District\",\"country\":\"Israel\",\"ranking\":{\"current_aqi\":17,\"current_aqi_cn\":6}},{\"city\":\"Rotterdam\",\"state\":\"Zuid-Holland\",\"country\":\"Netherlands\",\"ranking\":{\"current_aqi\":16,\"current_aqi_cn\":6}},{\"city\":\"Matosinhos\",\"state\":\"Porto\",\"country\":\"Portugal\",\"ranking\":{\"current_aqi\":15,\"current_aqi_cn\":16,\"last_aqi\":15,\"last_aqi_cn\":16}},{\"city\":\"Vienna\",\"state\":\"Vienna\",\"country\":\"Austria\",\"ranking\":{\"current_aqi\":15,\"current_aqi_cn\":5}},{\"city\":\"Sydney\",\"state\":\"New South Wales\",\"country\":\"Australia\",\"ranking\":{\"current_aqi\":14,\"current_aqi_cn\":5}},{\"city\":\"Bern\",\"state\":\"Bern\",\"country\":\"Switzerland\",\"ranking\":{\"current_aqi\":14,\"current_aqi_cn\":20,\"last_aqi\":14,\"last_aqi_cn\":20}},{\"city\":\"Helsinki\",\"state\":\"Uusimaa\",\"country\":\"Finland\",\"ranking\":{\"current_aqi\":13,\"current_aqi_cn\":4}},{\"city\":\"Oslo\",\"state\":\"Oslo\",\"country\":\"Norway\",\"ranking\":{\"current_aqi\":13,\"current_aqi_cn\":5}},{\"city\":\"Ankara\",\"state\":\"Ankara\",\"country\":\"Turkey\",\"ranking\":{\"current_aqi\":12,\"current_aqi_cn\":13,\"last_aqi\":18,\"last_aqi_cn\":20}},{\"city\":\"Katowice\",\"state\":\"Slaskie\",\"country\":\"Poland\",\"ranking\":{\"current_aqi\":10,\"current_aqi_cn\":3}},{\"city\":\"Beograd\",\"state\":\"Central Serbia\",\"country\":\"Serbia\",\"ranking\":{\"current_aqi\":10,\"current_aqi_cn\":4}},{\"city\":\"Zagreb\",\"state\":\"Croatia\",\"country\":\"Croatia\",\"ranking\":{\"current_aqi\":9,\"current_aqi_cn\":19,\"last_aqi\":7,\"last_aqi_cn\":17}},{\"city\":\"Richards Bay\",\"state\":\"KwaZulu-Natal\",\"country\":\"South Africa\",\"ranking\":{\"current_aqi\":3,\"current_aqi_cn\":3,\"last_aqi\":5,\"last_aqi_cn\":5}}]}"}],"_postman_id":"98aa093c-2224-4e42-a589-b37ecbbb1aa3"}],"id":"36e6a6bb-50c6-4c54-bea1-90cef70273c9","_postman_id":"36e6a6bb-50c6-4c54-bea1-90cef70273c9","description":""}],"id":"275daeb0-d34d-408a-bc03-f74d097a4eae","description":"

Mon 6 Feb 2017, we have introduced version 2 of API. New version consolidates multiple API calls and provides better structure to API response. Structure is controlled by the subscription plan. Version 1 remains operational.

\n","_postman_id":"275daeb0-d34d-408a-bc03-f74d097a4eae"}],"event":[{"listen":"prerequest","script":{"id":"23c246df-df41-4200-8463-eee6cc51e832","type":"text/javascript","exec":[""]}},{"listen":"test","script":{"id":"8bf0739a-847d-411d-8b15-8c32b47e3214","type":"text/javascript","exec":[""]}}]}

Get started

HTTPS support

Important notes

Return codes

Detailed response example

Changelog

Version 2.1.3 08/09/2025

Version 2.1.2 06/08/2025

Version 2.1.1 27/09/2017

Version 2.1 15/09/2017

Version 2.0 06/02/2017

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Parameters

Version 2.1.3 `08/09/2025`

Version 2.1.2 `06/08/2025`

Version 2.1.1 `27/09/2017`

Version 2.1 `15/09/2017`

Version 2.0 `06/02/2017`