Suburbs and localities to postal areas correspondence, 2021, Australia
liveThe file CG_SAL_2021_POA_2021.xlsx from the ABS ASGS Geographic Correspondences (2021) Edition 3. Each row is one suburb or locality and one postal area, with the share of the suburb's population that the ABS places in that postal area and the ABS's quality indicators. The ABS rows for no usual address, migratory, offshore and shipping, and outside Australia are kept, so every ABS code is in the table.
Also called: suburb to postcode correspondence, postcode to suburb lookup Australia, SAL to POA correspondence 2021, CG_SAL_2021_POA_2021.
- What is in each row?
- One pair of a suburb or locality and a postal area that it shares population with, as the ABS publishes the pair in its 2021 correspondence. A suburb that lies in one postal area has one row with a ratio of 1. A suburb split across postal areas has a row for each, and its ratios add to 1.
- How is the ratio worked out?
- The ABS weights its standard correspondences by where people live, using population modelled to residential address locations. The ratio is the share of the suburb's population that the ABS places in the postal area. This site publishes the ratio as the ABS gives it and computes none of its own.
- What do the quality columns mean?
- The ABS rates each row and the whole correspondence as Good, Acceptable or Poor, by how well it expects data to convert from the suburb to the postal area. The flag
bmos_null_flagis 0 for an ordinary row and 1 for a row whose ratio is below the ABS's minimum output size, usually 0.01. - How does this join to other datasets here?
- The suburb code matches
sal_2021_codein the ABS suburb and locality boundaries, and the postal area code matchespoa_2021_codein the ABS postal area boundaries. Both codes are text, so Northern Territory postcodes keep their leading zero, such as 0800.
Made for agents
Connect your AI agent
Any agent that connects to publicdata.au/mcp can find this dataset, read its 7 fields, count and filter across all 15,433 rows and diff its versions. Every answer names the version and carries ABS's attribution. No key.
Then ask it: What does Suburbs and localities to postal areas correspondence, 2021, Australia hold, and what changed in the newest version?
claude mcp add --transport http publicdata https://publicdata.au/mcp One command. No key, no account, no sign-up.
Settings, then Connectors, then Add custom connector, and paste https://publicdata.au/mcp.
On the web and in the desktop app.
https://publicdata.au/mcp Streamable HTTP. Cursor, VS Code or any client that connects to a remote MCP server.
Using https://publicdata.au/llms.txt, how many people died on Queensland roads in 2025, by month? For an assistant that reads the web and has no connector.
A dashboard over every row. Click to filter, add panels, share a link or embed a frame.
Query APIFilter and count from a URLaggregate?group=quality_indicator&metric=count&ratio_from_to=lt.1
Suburbs split across postal areas, by the ABS quality rating: 146 Good, 4 Acceptable, 1 Poor.
Download it as Excel, CSV, JSON and 5 more formats
Pick a format and a version. Excel is picked first because it opens in the tools most offices have. The URL is yours to keep. A dated version keeps its content.
One workbook with a records sheet of 15,433 typed rows, a fields sheet and a publicdata sheet with the provenance. Dates are real Excel dates. Opens in Excel, Numbers, LibreOffice and Sheets.
UTF-8 without a byte-order mark, RFC 4180 quoting, one header row using the normalised field names. Opens in Excel, Numbers and Sheets.
One object with a publicdata header (publisher, licence, attribution, version, source hash), a fields list and a records array of 15,433 objects with typed values. Blank cells are null.
Columnar and typed. The smallest download and the fastest to query. Reads directly in DuckDB, pandas, Polars, Arrow and Spark. The provenance header is in the file metadata.
One database with a records table, a fields table and a publicdata metadata table. Open it with any SQLite client.
One DuckDB database with a records table of typed columns, a fields table and a publicdata metadata table. It attaches read-only over HTTPS, so DuckDB, Python and R can query it without downloading it.
The first line is the provenance header, then one JSON object per line. For streaming and for tools that read line by line.
The same CSV, gzipped, at about a tenth of the size. curl, pandas, DuckDB and R read it directly.
In your own tools
Use it in Excel, R, Python and more
Excel and Power BI read the CSV from its address and refresh from it. The R and Python packages take any dataset on this site by its slug, so a new dataset needs no new release. The DuckDB file attaches read-only over HTTPS, and a query reads only the blocks it touches.
The dated URL in the code never changes. https://publicdata.au/d/abs-suburbs-to-postal-areas-2021/latest/ redirects to the newest version.
https://publicdata.au/d/abs-suburbs-to-postal-areas-2021/latest/data.csv In Excel choose Data, then From Web, and paste this address. Excel keeps it, so Refresh All reads the newest version. A sheet holds about a million rows; past that, load the query to the Data Model.
https://publicdata.au/d/abs-suburbs-to-postal-areas-2021/latest/data.csv In Power BI Desktop choose Get data, then Web, paste this address and choose Anonymous when asked how to sign in. A scheduled refresh reads the same address, so the report follows each new version.
library(publicdataau)
df <- pd_read("abs-suburbs-to-postal-areas-2021")
pd_attribution(df) install.packages("publicdataau"). pd_read() fetches the version's Parquet file; pd_rows() and pd_aggregate() ask the query API instead, and pd_connect() attaches the DuckDB file.
import publicdata_au as pd_au
df = pd_au.read("abs-suburbs-to-postal-areas-2021")
df.attrs["publicdata"]["attribution"] pip install "publicdata-au[pandas]". read() fetches the version's Parquet file; rows() and aggregate() ask the query API, and connect() attaches the DuckDB file.
INSTALL httpfs; LOAD httpfs;
ATTACH 'https://publicdata.au/d/abs-suburbs-to-postal-areas-2021/v/2026-10-14/data.duckdb' AS abs_suburbs_to_postal_areas_2021 (READ_ONLY);
SELECT sal_2021_code, count(*) FROM abs_suburbs_to_postal_areas_2021.records GROUP BY 1 ORDER BY 2 DESC; The DuckDB file attaches read-only over HTTPS and only the blocks a query touches are read. Parquet works the same way: FROM read_parquet(url).
const res = await fetch("https://publicdata.au/api/v1/datasets/abs-suburbs-to-postal-areas-2021/aggregate?group=quality_indicator&metric=count&ratio_from_to=lt.1");
const { rows, publicdata } = await res.json();
console.log(rows, publicdata.attribution); The query API answers a page on any site as well as Node, with no key. It returns the rows and the attribution the licence asks for.
What is in it
Column names are made snake_case and the publisher's original header is kept beside each one. Blank cells are null. Nothing is added, removed, ranked or summarised.
| Field | Type | Publisher's header | Note |
|---|---|---|---|
| sal_2021_code | string | SAL_CODE_2021 | |
| sal_2021_name | string | SAL_NAME_2021 | |
| poa_2021_code | string | POA_CODE_2021 | |
| ratio_from_to | number | RATIO_FROM_TO | |
| quality_indicator | string | INDIV_TO_REGION_QLTY_INDICATOR | |
| overall_quality_indicator | string | OVERALL_QUALITY_INDICATOR | |
| bmos_null_flag | integer | BMOS_NULL_FLAG |
Download this table as a data dictionary (Excel), or read it as a Frictionless Table Schema at schema.json. The key is sal_2021_code, poa_2021_code.
A sample of 10 rows
From the latest version, each quality of this pair in turn, then in the publisher's order, with every field. A blank cell is shown as null.
| sal_2021_code | sal_2021_name | poa_2021_code | ratio_from_to | quality_indicator | overall_quality_indicator | bmos_null_flag |
|---|---|---|---|---|---|---|
| 10001 | Aarons Pass | 2850 | 1 | Good | Good | 0 |
| 11649 | Glen Alpine | 2563 | 0.012205 | Acceptable | Good | 0 |
| 21640 | Melbourne | 3004 | 0.208926 | Poor | Good | 0 |
| 10002 | Abbotsbury | 2176 | 1 | Good | Good | 0 |
| 12580 | Menangle Park | 2563 | 1 | Acceptable | Good | 0 |
| 10003 | Abbotsford (NSW) | 2046 | 1 | Good | Good | 0 |
| 20495 | Carlton (Vic.) | 3000 | 0.000999 | Acceptable | Good | 1 |
| 10004 | Abercrombie | 2795 | 1 | Good | Good | 0 |
| 21640 | Melbourne | 3000 | 0.784082 | Acceptable | Good | 0 |
| 10005 | Abercrombie River | 2795 | 1 | Good | Good | 0 |
The first row as JSON
As it appears in data.json.
GET https://publicdata.au/d/abs-suburbs-to-postal-areas-2021/latest/data.json
{
"sal_2021_code": "10001",
"sal_2021_name": "Aarons Pass",
"poa_2021_code": "2850",
"ratio_from_to": 1.0,
"quality_indicator": "Good",
"overall_quality_indicator": "Good",
"bmos_null_flag": 0
}
Query it without downloading
The query API returns only the rows you ask for, as JSON, NDJSON or CSV, from the same typed rows as the files. It needs no key. Build a query here and run it, then copy the URL or the code into your own work.
How filters work
Each filter is field=operator.value in the query string, and every filter must match. A number or date field compares as a number or date, and a text field compares as text. Values are case-sensitive, except that like and ilike ignore case in the ASCII letters A to Z. Prefix not. to negate a filter, as not.eq.value.
| Operator | What it matches |
|---|---|
| eq.value | Equal to the value. |
| neq.value | Not equal to the value. A blank cell does not match. |
| gt.value | Greater than the value. |
| gte.value | Greater than or equal to the value. |
| lt.value | Less than the value. |
| lte.value | Less than or equal to the value. |
| like.*text* | Matches a pattern where * stands for any run of characters, ignoring case in the ASCII letters A to Z. |
| ilike.*text* | The same as like. Both ignore case in ASCII letters only, so É and é differ. |
| in.(a,b,c) | Equal to any value in the list. A value cannot contain a comma. |
| is.null | Blank in the source, or suppressed by the publisher. |
| Parameter | What it does |
|---|---|
| select | Fields to return, comma-separated. Every field when absent. |
| order | field.asc or field.desc, comma-separated. When absent, rows come in the order of the file they are read from. For the newest versions that is the version's own data.parquet, which keeps the publisher's order unless the dataset sorted it. Any other version is read from the Parquet file the answer names in file, and when that file is sorted the answer names its sort in order, which ties follow too. |
| limit | Rows per page, 1 to 10,000. 100 when absent. |
| offset | Rows to skip. The next URL in each answer sets it for you. |
| group | On aggregate, fields to group by, comma-separated. |
| metric | On aggregate, count, sum.field, avg.field, min.field or max.field, comma-separated. count when absent. |
| format | json, ndjson or csv. JSON carries the provenance header, and the others carry it in response headers. |
Without a version the API answers from the newest version, and that answer changes when the publisher releases again. Put versions/<date>/ before rows or aggregate for an answer from that version alone. Every version with a table can be queried, and /api/v1/datasets/<slug>/versions lists them. A query on a version the database does not hold is read from its Parquet file, and one that would read too much of it is refused with DuckDB SQL that answers it from the file. The 1 newest version is loaded; versions lists them.
The API allows 60 requests in 10 seconds from one address. Above that it answers 429 for 10 seconds with a Retry-After header, a RateLimit-Policy header and a JSON body that gives the limit. Every API answer carries the same RateLimit-Policy. A client should wait the Retry-After seconds, or read the files, which have no limit. openapi.json describes this dataset's query paths for client generators and agents.
https://publicdata.au/mcp is a remote MCP server over Streamable HTTP with the same tools, defined in the same place, so a tool added to the pages is added here too. It needs no key and no account. Its row tools and the query API answer every version through one query path, so a tool's answer and the query URL it cites give the same rows. A query that would read too much of a file is refused with DuckDB SQL that answers it from the file. It also has search and fetch, the two tools ChatGPT's deep research and company knowledge call by name, which run search_datasets and read a dataset's record in the shapes those features expect. The row tools are held to the query API's limit of 60 queries in 10 seconds from one address, and each call is two queries because it also counts the matching rows. Add it to Claude Code with claude mcp add --transport http publicdata https://publicdata.au/mcp, add the URL in Claude as a custom connector, or give it to any client that connects to remote MCP servers. Each dataset with a table is also a resource at https://publicdata.au/d/<slug>/fields.json, which lists its fields with their types, the publisher's descriptions, their ranges and the values they hold, so an agent can read a dataset's shape before it writes a query.
What changed
One version for every release the publisher has made since this site started following the dataset. The date is the day the file changed on the portal.
- 2026-10-14 15,433 rows7 fieldszip3c4ca9307b86
versions.json · changes.json · history.tar.zst (157 KB, every version's Parquet and manifest)
Questions
How do I download Suburbs and localities to postal areas correspondence, 2021 as a CSV file?
Open https://publicdata.au/d/abs-suburbs-to-postal-areas-2021/latest/data.csv. It redirects to the newest dated version, which is https://publicdata.au/d/abs-suburbs-to-postal-areas-2021/v/2026-10-14/data.csv today. The same path serves Excel, JSON, Parquet, SQLite, DuckDB, NDJSON. A dated URL never changes, so use it when the file must stay the same.
Can I open Suburbs and localities to postal areas correspondence, 2021 in Excel?
Yes. https://publicdata.au/d/abs-suburbs-to-postal-areas-2021/v/2026-10-14/data.xlsx is a workbook with the 15,433 rows on a records sheet, the field list on a second sheet and the provenance on a third. The CSV also opens in Excel. https://publicdata.au/d/abs-suburbs-to-postal-areas-2021/v/2026-10-14/data.csv.gz is the CSV at about a tenth of the size.
How often is Suburbs and localities to postal areas correspondence, 2021 updated?
ABS releases it when the ABS releases a new edition, after each Census. This site checks the portal every week and adds a dated version when the file changes.
Can I use Suburbs and localities to postal areas correspondence, 2021 commercially?
Yes. CC BY 4.0 allows commercial use, redistribution and derived works as long as the attribution is kept. The attribution string is in this page's side column and inside every file.
Is this the official source for Suburbs and localities to postal areas correspondence, 2021?
No. The publisher is Australian Bureau of Statistics, and its page is https://data.gov.au/data/dataset/asgs-edition-3-2021-correspondences. National Digital converted the publisher's file to other formats. It renamed and typed the columns and kept only those the schema lists. National Digital made these changes, and the publisher is not responsible for them. The original sits beside every version as source.zip with its SHA-256, so the two can be compared.
What this site did to the data. Cells were typed, headers were renamed and the encoding was made UTF-8. Rows were left alone. The publisher's file sits beside every version as source.zip so the change can be checked.
The licence requires the publisher's attribution. We ask that you also name publicdata.au and link to the version you used.
Australian Bureau of Statistics, ASGS Geographic Correspondences (2021) Edition 3, CG_SAL_2021_POA_2021.xlsx, sourced 26 October 2026, https://data.gov.au/data/dataset/asgs-edition-3-2021-correspondences, licensed under CC BY 4.0. Serialised and versioned by National Digital at publicdata.au, https://publicdata.au/d/abs-suburbs-to-postal-areas-2021/v/2026-10-14/
The attribution alone is inside every file. Harvard is the author-date form a report or a brief asks for. Paste the HTML on a web page so the links carry.
Australian Bureau of Statistics states the licence, CC BY 4.0, on its own page, which was read and recorded here on 23 October 2026.
Every fetch reads the licence again and stops when it has changed. The fetch that made version 2026-10-14 read it from data.gov.au on 26 October 2026.
- Hugging Faceload_dataset("National-Digital/abs-suburbs-to-postal-areas-2021")
- Kagglewith a starter notebook
- ZenodoDOI 10.5281/zenodo.23678823
Each copy carries the same attribution and links back to this page.
- datapackage.jsonFrictionless data package pointing at the latest version
- schema.jsonTable Schema for every field
- schema.xlsxthe same field list as an Excel data dictionary
- versions.jsonevery version with date, rows, fields and hash
- changes.jsondiff for every consecutive pair
- manifest.jsonwhere the bytes came from and when
- Query APIfiltered rows and counts without a download
- openapi.jsonOpenAPI 3.1 for this dataset's query paths
- explore/charts and dashboards in the browser, shareable and embeddable
- index.mdthis page as Markdown
This page carries a schema.org Dataset record and is listed in /.well-known/ard.json and /catalog.json.
Australian Bureau of Statistics publishes this table on data.gov.au. Questions about the content go to the publisher. Questions about the files here go to corrections.
Fetched 26 October 2026. Source SHA-256 3c4ca9307b86dd9c…
This page is built from register/abs-suburbs-to-postal-areas-2021.yaml on GitHub. Anyone can propose a fix to it, such as a clearer description or a field the publisher renamed, as a pull request.
Report a file that differs from the publisher's · How to contribute