---
title: "List Australian Postcodes & Geolocation records"
method: GET
path: "/v1/data/australian-postcodes-geolocation"
tags: ["Geospatial"]
---

# List Australian Postcodes & Geolocation records

`GET /v1/data/australian-postcodes-geolocation`

## Request

- Base URL: `https://api.aristocles.com.au` (the document declares no server; this is the origin it was published from)
- URL: `https://api.aristocles.com.au/v1/data/australian-postcodes-geolocation`
- Auth: none declared. Required headers: `X-API-Key`

List Australian Postcodes & Geolocation records with optional filters and pagination.

**Source:** Based on data from Matthew Proctor and contributors (CC BY 4.0).

**Fields returned:**
- `postcode` (int) — The 4-digit Australian postcode.
- `locality` (str) — The official suburb or locality name.
- `state` (str) — The state or territory abbreviation (e.g., NSW, VIC).
- `latitude` (float) — The GPS latitude coordinate of the locality's centre.
- `longitude` (float) — The GPS longitude coordinate of the locality's centre.

**Example:** `GET /v1/data/australian-postcodes-geolocation?limit=10&state=example`

## Query parameters

- `limit` integer: Max records to return (1-100).
- `offset` integer: Records to skip, for pagination.
- `state` string, nullable: The state or territory abbreviation (e.g., NSW, VIC).

## Headers

- `X-API-Key` string, required

## Response `200`

A page of Australian Postcodes & Geolocation records with pagination metadata.

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/aristocles/apis/aristocles-data-api.md) · [All operations](https://skmtc.dev/aristocles/apis/aristocles-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/aristocles/apis/aristocles-data-api/revisions/4ca3fbb73c59?raw)