Geospatial · Data API

Australian Postcodes & Geolocation

A complete database of Australian postcodes, suburbs, and their geographic coordinates.

Provides a lookup for all Australian postcodes, mapping them to suburbs, states, and precise latitude/longitude coordinates. This is foundational data for any app with address forms, shipping calculators, or location-based services.

Get API keyView docs

Source: Matthew Proctor's Australian Postcodes (Community-Sourced) · CC BY 4.0 · Based on data from Matthew Proctor and contributors

Endpoints

Every request is authenticated with your X-API-Key and counted against your plan.

  • GET /v1/data/australian-postcodes-geolocation
  • GET /v1/data/australian-postcodes-geolocation/search?q=...
  • GET /v1/data/australian-postcodes-geolocation/{key}

Base path /v1/data/australian-postcodes-geolocation · full reference in the interactive docs. Also exposed as an MCP tool for AI agents.

Fields

FieldTypeDescription
postcodeintThe 4-digit Australian postcode.
localitystrThe official suburb or locality name.
statestrThe state or territory abbreviation (e.g., NSW, VIC).
latitudefloatThe GPS latitude coordinate of the locality's centre.
longitudefloatThe GPS longitude coordinate of the locality's centre.

What you get

Comprehensive coverage of all Australian postcodes and localities.
Includes precise latitude and longitude for mapping.
High-quality, community-maintained data.
Simple, clean CSV structure.
Openly licensed for commercial use with attribution.

FAQ

How accurate is the geodata?
The coordinates typically represent the approximate centre of the suburb or postcode area, and are suitable for most location-based applications.
Is this data the same as the official Australia Post database?
It is a community-sourced equivalent. It is widely used and considered highly accurate, but is not the official licensed product from Australia Post.

Pricing

Simple, transparent pricing

Start free, upgrade when you need more. All plans include full API access.

Free

$0forever

Get started and explore the API

100 requests/day
  • 100 API requests per day
  • All endpoints included
  • Community support
Get Started
Most popular

Pro

$9/month

For production apps and AI agents

10,000 requests/day
  • 10,000 API requests per day
  • All endpoints included
  • Priority support
  • Usage dashboard
Upgrade to Pro

Enterprise

$49/month

Unlimited access for high-volume use

Unlimited requests
  • Unlimited API requests
  • All endpoints included
  • Priority support
  • Usage dashboard
  • Dedicated support channel
Go Enterprise

Getting Started

Start building in minutes

Register for a free API key, make your first request, and upgrade when you're ready.

1

Register

Create an account to get your API key. It's free — no credit card required.

curl -X POST https://api.aristocles.com.au/v1/auth/register \
  -H "Content-Type: application/json" \
  -d '{"email": "you@example.com", "name": "Your Name"}'
2

Make a request

Use your API key in the X-API-Key header to authenticate requests.

curl https://api.aristocles.com.au/v1/data/asx \
  -H "X-API-Key: your_api_key_here"
3

Upgrade

Need more requests? Upgrade to Pro or Enterprise — you'll be redirected to Stripe Checkout.

curl -X POST "https://api.aristocles.com.au/v1/billing/checkout?tier=pro" \
  -H "X-API-Key: your_api_key_here"
4

Check usage

Monitor your daily request count and remaining quota at any time.

curl https://api.aristocles.com.au/v1/usage \
  -H "X-API-Key: your_api_key_here"