GET
/v1/addresses?q=Autocomplete an address as someone types.
Australia,
addressed.
Every Australian address has a place.
Find it with one address API.
Autocomplete, coordinates and boundaries for 16,091,511 Australian addresses.
16,091,511addresses, one reference. Usage in numbers. Browse postcodes
Addresses per 0.2° cell
Logarithmic density
Geoscape G-NAFLogarithmic density
1101001k10k100k+
Refreshed quarterly
Start free. Grow when you need to.
10,000 lookups a month on the free key, no card. Paid plans from $29 a month for 100,000 lookups, first month free. See the plans.
Find the address.
Work with the geography.
From the first keystroke to a full address record. Use the same API for coordinates, postcodes and the boundaries around them.
GET
/v1/nearest?lat=&lng=Reverse geocode a point, with distanceMetres.
GET
/v1/addresses?postcode=List the addresses at a postcode.
GET
/v1/postcodes/:postcodeFind suburbs, state and a postcode centroid.
GET
/v1/addresses/:idResolve a G-NAF identifier to the full record, boundaries included.
GET
/v1/postcodes?q=Autocomplete postcodes and suburb names.
POST
/v1/parseTurn messy text into ranked matches with a confidence.
GET
/v1/boundaries/:layer/:codeLook up a boundary by its official layer and code.
POST
/v1/addresses/bulkSend up to 100 queries together. Each counts as a lookup.
POST
/v1/jobsWork through a CSV of addresses as a job, matched and geocoded.
Request formats and response examples in the API reference. Also available as OpenAPI 3.1.
Plans that start at nothing.
A free key to build with, then small monthly plans in Australian dollars. The unit price falls as the allowance grows. Change or cancel from your account at any time.
| Plan | AUD a month | AUD a year | Lookups a month | Parses | CSV rows | Keys | Notes |
|---|---|---|---|---|---|---|---|
| Free | Free | Free | 10,000 | 1,000 | None | 1 | No card, no expiry. |
| Pro | $29 a month | $290 a year | 100,000 | 10,000 | 100,000 | 5 | First month free. |
| Scale | $99 a month | $990 a year | 500,000 | 50,000 | 500,000 | 25 | First month free. |
Prices are in Australian dollars, billed by Stripe, cancel any time from your account. Annual plans cost ten months, so two months are free. Paid plans start with a free month, with a card on file and nothing charged until it ends. Lookups are per key per UTC calendar month. Bulk requests count once per query and CSV jobs once per row. Need more than the largest plan, or an invoice? Reply to any email from the service.
A point, with context.
The address, its coordinates and its boundaries arrive together in one response. Official codes are ready to join to your own data.
GET/v1/addresses?q=9+George+Street%2C+Sydneyapplication/json
{
"ok": true,
"release": "AUG 2026 - Geoscape G-NAF - GDA2020",
"results": [
{
"uprn": "GANSW718028803",
"line1": "9 George Street",
"line2": null,
"suburb": "Sydney",
"state": "NSW",
"postcode": "2000",
"latitude": -33.86580248,
"longitude": 151.20700223,
"boundaries": {
"sa1": "11703164421",
"sa2": {
"code": "117031644",
"name": "Sydney (North) - Millers Point"
},
"sa3": {
"code": "11703",
"name": "Sydney Inner City"
},
"sa4": {
"code": "117",
"name": "Sydney - City and Inner South"
},
"gccsa": {
"code": "1GSYD",
"name": "Greater Sydney"
},
"remoteness": {
"code": "10",
"name": "Major Cities of Australia"
},
"lga": {
"code": "17200",
"name": "Sydney"
},
"electorate": {
"federal": {
"code": "141",
"name": "Sydney"
},
"state": {
"code": "10078",
"name": "Sydney"
}
},
"postalArea": "2000",
"suburb": {
"code": "13730",
"name": "Sydney"
},
"mmm": {
"category": 1,
"name": "Metropolitan"
}
}
}
]
}Full response, including null fields. Scroll to explore. Every address lookup returns this shape.
9 George Street, Sydney
A stable G-NAF identifier, address lines, suburb, state and postcode, with GDA2020 latitude and longitude. line2 is null when no building or site name is supplied. Twelve ABS and health geography layers arrive on the same record.
- SA1
- 11703164421
- SA2
- Sydney (North) - Millers Point
- SA3
- Sydney Inner City
- SA4
- Sydney - City and Inner South
- Capital city area
- Greater Sydney
- Remoteness
- Major Cities of Australia
- Local government
- Sydney 17200
- Electorates
- Sydney, federal 141
Sydney, state 10078 - Postal area
- 2000
- Suburb / locality
- Sydney 13730
- Modified Monash
- 1, Metropolitan
Postal area is an ABS geography and can differ from the delivery postcode. Codes are the official ABS and AEC codes.
One key.
Clear limits.
Send your key in the x-api-key header. Keys start with sak_live_ and are shown once. You can also use Authorization: Bearer. Health, status and docs need no key.
curl "https://addresses.sessional.au/v1/addresses?q=9+george+st+sydney" \ -H "x-api-key: $SESSIONAL_ADDRESS_KEY"
10,000lookups a month on the free key
10 / secburst limit on every key
Know where you stand
X-RateLimit-Limit is your plan's monthly allowance, X-RateLimit-Remaining the balance and X-RateLimit-Reset the reset date. You get an email at 80 percent and at the limit.
Handle the limit
Over the limit returns 429 with Retry-After. Bulk requests count once for each query inside them, and CSV jobs once per row. Move up a plan when you need more.
Geoscape G-NAF
AUG 2026 - Geoscape G-NAF - GDA2020. Australian addresses and GDA2020 coordinates via data.gov.au. G-NAF EULA, attribution required.
G-NAF on data.gov.auABS ASGS Edition 3
Mesh Block allocations for statistical areas, remoteness, local government areas, electorates, postal areas and suburbs, from the Australian Bureau of Statistics.
CC BY 4.0
Modified Monash 2023
Category 1 to 7 by Mesh Block from the Australian Government Department of Health and Aged Care, via data.gov.au.
CC BY 2.5 AU
Questions people ask before they sign up.
How much does the address API cost?
Every verified email address gets a free key with 10,000 lookups a month and no card. Paid plans are billed in Australian dollars from $29 a month for 100,000 lookups, with the first month free, and an annual option costs ten months. Plans can be changed or cancelled from the billing portal, and keys can be revoked or rotated from your account at any time.
Where does the address data come from?
Addresses and coordinates come from G-NAF, the Geocoded National Address File published by Geoscape Australia as open data through data.gov.au. Boundaries come from the Australian Bureau of Statistics ASGS Edition 3 allocation files, and the Modified Monash category from the Department of Health and Aged Care. The service reloads each quarterly G-NAF release.
What does one lookup return?
The address on one or two lines, suburb, state, postcode, GDA2020 latitude and longitude, a stable G-NAF identifier, and the boundaries the address sits in: statistical areas, local government area, federal and state electorates, remoteness area, postal area, suburb and Modified Monash category.
Can I geocode and reverse geocode?
Yes. Every address record carries its property centroid where G-NAF has one, and the nearest endpoint returns the closest addresses to a latitude and longitude with distances in metres.
Does it handle misspelt or unstructured addresses?
The parse endpoint takes free text, such as a pasted delivery line or a line from a spreadsheet, splits it into components, and ranks G-NAF matches with a confidence and the components that matched. PO boxes are recognised and never matched to a street address.
Can I use it in production?
Yes. Responses carry ETag and Cache-Control headers so you can cache freely, the status page shows the current release and load date, and the OpenAPI document is tested against the running routes on every build. Display the G-NAF attribution on any public product that uses the data.
How do I look up a postcode?
Ask for the postcode itself to get the suburbs it covers, the state and a centroid, or search postcodes and suburbs by prefix or name for autocomplete. A postcode filter on the address endpoint lists every address at that postcode.