AirHealth API

Disclaimer: This documentation and API are for personal use only.

Getting Started

Welcome to the Air Health Services Public API. Our API provides access to environmental health data including grass pollen forecasts, other allergen forecasts, and air quality/woodsmoke information across Australia.

1

Sign Up

Create a free account to get started.

2

Purchase a Plan

Choose a plan that fits your needs and complete payment through Stripe.

3

Generate API Token

Navigate to your dashboard and generate your API key to start making requests.

Available Plans

Choose from three specialized APIs or get full access with Total Access. Each plan includes a monthly quota of API calls. Each call targets one specific SAL (Suburb and Locality -- see below for details), essentially a geographical region slightly smaller than a suburb. All forecasts provide 3-day predictions for anywhere in Australia.

Grass Pollen

3-day grass pollen forecast for anywhere in Australia. These are daily forecasts to help manage hay fever symptoms powered by ML models and automated pollen counters around Australia.

Other Allergens

3-day forecasts for tree pollen (Birch, Cypress, Eucalypt, Olive, Plane), weed pollen (Plantain), and fungal spores (Alternaria) across Australia.

AQ & Woodsmoke

3-day air quality index and woodsmoke exposure forecasts for any Australian location, including PM2.5 and O3 data.

Total Access

Full access to all three APIs. Call any endpoint with a single plan for comprehensive environmental health data across Australia.

Understanding SAL Codes

SAL (Suburb and Locality) codes are geographic identifiers used by the Australian Bureau of Statistics (ABS) to represent suburbs and localities across Australia. Each SAL code corresponds to a specific geographic area, it is similar but not identical to a suburb.

Use the Find Your Location tool below to convert coordinates (latitude, longitude) into the corresponding SAL code for your area of interest.

Also you can learn more about SAL design criteria at the ABS website →

Endpoint Specs

Base URL: https://api-public.airhealthservices.au

Grass Pollen Forecast

GET /api/v1/grass-pollen

https://api-public.airhealthservices.au/api/v1/grass-pollen?sal=<YOUR_SAL_CODE>

Update Schedule: New forecasts are available by 7:30 AM AEST each day.

View Example Response

{
  "sal": "",
  "forecast": [
    {
      "date": "2025-11-10",
      "grass_level": "Low"
    },
    {
      "date": "2025-11-11",
      "grass_level": "Moderate"
    },
    {
      "date": "2025-11-12",
      "grass_level": "Moderate"
    }
  ]
}

Other Allergens Forecast

GET /api/v1/other-allergens

https://api-public.airhealthservices.au/api/v1/other-allergens?sal=<YOUR_SAL_CODE>

Update Schedule: New forecasts are available by 8:30-9:00 AM AEST each day.

View Example Response

{
  "sal": "",
  "forecast": [
    {
      "date": "2025-11-10",
      "overall_level": "Extreme",
      "allergens": [
        {"name": "Plantain", "level": "Low"},
        {"name": "Birch", "level": "Extreme"},
        {"name": "Cypress", "level": "High"},
        {"name": "Eucalypts", "level": "Low"},
        {"name": "Olive", "level": "Extreme"},
        {"name": "Plane", "level": "High"},
        {"name": "Alternaria", "level": "Low"}
      ]
    },
    ...
  ]
}

AQ & Woodsmoke Forecast

GET /api/v1/aq-woodsmoke

https://api-public.airhealthservices.au/api/v1/aq-woodsmoke?sal=<YOUR_SAL_CODE>

Update Schedule: Woodsmoke forecasts are updated once daily in the morning. PM2.5 and O3 air quality data are updated 4 times per day.

View Example Response

{
  "sal": "",
  "forecast": [
    {
      "date": "2025-11-10",
      "aq_level": "Very Good",
      "woodsmoke_level": "Low",
      "supporting_data": [
        {"name": "PM2.5", "level": "Very Good"},
        {"name": "O3", "level": "Very Good"}
      ]
    },
    ...
  ]
}

Authentication

All API requests require authentication using your API Key. Include your key in the Authorization header of each request.

Header Format:

Authorization: Api-Key YOUR_API_KEY

Error Handling

Code	Description
200	Success
400	Bad Request
401	Unauthorized
403	Forbidden (Quota exceeded or invalid permissions)
429	Too Many Requests
500	Server Error
503	Service Unavailable

Quotas & Limits

Each plan includes a monthly quota. Quota resets at 00:00:01 UTC on the 1st of each month and is tracked in UTC. Additional per-second limits may apply.

Code Examples

Choose your preferred language or format to get started quickly.

curl -X GET "https://api-public.airhealthservices.au/api/v1/grass-pollen?sal=20601" \
     -H "Authorization: Api-Key YOUR_API_KEY"

GET /api/v1/grass-pollen?sal=20601 HTTP/1.1
Host: api-public.airhealthservices.au
Authorization: Api-Key YOUR_API_KEY

import requests

url = "https://api-public.airhealthservices.au/api/v1/grass-pollen"
headers = {
    "Authorization": "Api-Key YOUR_API_KEY"
}
params = {
    "sal": "20601"
}

response = requests.get(url, headers=headers, params=params)
data = response.json()
print(data)

Find Your Location (SAL Code)

Our API uses SAL (Statistical Area Level) codes to identify locations. Use this tool to find the SAL code for a specific coordinate.
Note: This request requires your API Key but does not count towards your monthly quota.

API Key

Coordinate (lat,long)

Tip: To find coordinates of a location, use Google Maps. Click on any location or right-click to see the coordinates.

Result

Enter key and coordinates...

Try it Live

Endpoint

API Key

Response

Click "Call endpoint" to test...