publicdata.au publicdata.au on GitHub

Suburb and locality boundaries, South Australia

live
Publisher Department for Housing and Urban DevelopmentUpdated when the publisher updates the layerLicence CC BY 4.0Latest 2026-06-28Rows 1,895Fields 4

South Australian suburb and locality boundaries from the Department for Housing and Urban Development. Each row is one suburb or locality with its name in capitals, the postcode, the publisher's suburb number and the date the boundary took legal effect.

Also called: SA Suburbs shapefile, South Australian suburb and locality boundaries, Adelaide suburb boundaries GeoJSON.

Before you use it
What is in each row?
One gazetted suburb or locality of South Australia with its name, the postcode the publisher gives it, its suburb number and the date its boundary took legal effect where the publisher records one. The shape is in the GeoParquet, GeoJSON, GeoPackage and PMTiles files.
How does this differ from the national localities layer?
This is the South Australian Government's own suburb layer, kept by the Department for Housing and Urban Development. The national localities on this site come from Geoscape's Administrative Boundaries, and the two may differ at the edges and in naming.
Why is the legal start date blank for some suburbs?
The publisher leaves it blank where it records no date. The blank is kept as a null.
1,895suburbs
1973 to 2025years drawn
4fields
12formats
1version
01002003001973: 11977: 21978: 51980: 41985: 41987: 319871989: 71990: 141991: 61992: 121993: 71994: 719941995: 401996: 191997: 401998: 661999: 2132000: 29420002001: 1272002: 642003: 1712004: 122005: 52006: 1520062007: 182008: 312009: 262010: 172011: 432012: 1520122013: 2892014: 442015: 192016: 212017: 192018: 620182019: 142020: 112021: 82022: 62023: 242025: 12025
Suburb boundaries taking legal effect per year, 1973 to 2025. 1970 is not drawn because the rows begin on 19 February 1970. 2026 is not drawn because the rows run to 30 April 2026. The figure is a count of rows from version 2026-06-28, worked out in the build. Nothing else is added.

Made for agents

Connect your AI agent

Any agent that connects to publicdata.au/mcp can find this dataset, read its 4 fields, count and filter across all 1,895 rows and diff its versions. Every answer names the version and carries Housing and Urban Development's attribution. No key.

Then ask it: What does Suburb and locality boundaries, South 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.

Download it as Excel, CSV, JSON and 9 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.

Format
"Latest" redirects to the newest version and will change when the publisher releases again. A dated version keeps its content.
https://publicdata.au/d/sa-suburb-boundaries/latest/data.xlsx
Download this file

One workbook with a records sheet of 1,895 typed rows, a fields sheet and a publicdata sheet with the provenance. Dates are real Excel dates. Opens in Excel, Numbers, LibreOffice and Sheets.

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/sa-suburb-boundaries/latest/ redirects to the newest version.

https://publicdata.au/d/sa-suburb-boundaries/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.

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.

FieldTypePublisher's headerNote
suburbstringsuburb
postcodestringpostcodeKept as text to preserve leading zeros.
suburb_numberintegersuburb_num
legal_startdatelegalstart

Download this table as a data dictionary (Excel), or read it as a Frictionless Table Schema at schema.json. The key is suburb_number.

A sample of 10 rows

From the latest version, newest first by legal start date, then in the publisher's order, with every field. A blank cell is shown as null.

suburbpostcodesuburb_numberlegal_start
BOWDEN50075007012026-04-30
BROMPTON50075007022026-04-30
SOUTHWARK50315031052025-10-30
COCKATOO VALLEY53515351022023-11-30
BAROSSA GOLDFIELDS53515351072023-11-30
LIPSON56075607042023-11-16
UNGARRA56075607032023-11-16
MARINO50495049022023-11-09
SEACLIFF50495049032023-11-09
SEACLIFF PARK50495049042023-11-09
The first row as JSON

As it appears in data.json.

GET https://publicdata.au/d/sa-suburb-boundaries/latest/data.json
{
  "suburb": "AMATA",
  "postcode": "0872",
  "suburb_number": 87206,
  "legal_start": null
}

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.

Try rows or aggregate for this dataset. The query builder needs JavaScript.

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.

OperatorWhat it matches
eq.valueEqual to the value.
neq.valueNot equal to the value. A blank cell does not match.
gt.valueGreater than the value.
gte.valueGreater than or equal to the value.
lt.valueLess than the value.
lte.valueLess 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.nullBlank in the source, or suppressed by the publisher.
ParameterWhat it does
selectFields to return, comma-separated. Every field when absent.
orderfield.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.
limitRows per page, 1 to 10,000. 100 when absent.
offsetRows to skip. The next URL in each answer sets it for you.
groupOn aggregate, fields to group by, comma-separated.
metricOn aggregate, count, sum.field, avg.field, min.field or max.field, comma-separated. count when absent.
formatjson, 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, connect the publicdata.au plugin in ChatGPT, 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.

versions.json · changes.json · history.tar.zst (15 MB, every version's Parquet and manifest)

Questions

How do I download Suburb and locality boundaries as a CSV file?

Open https://publicdata.au/d/sa-suburb-boundaries/latest/data.csv. It redirects to the newest dated version, which is https://publicdata.au/d/sa-suburb-boundaries/v/2026-06-28/data.csv today. The same path serves Excel, JSON, GeoJSON, Parquet, SQLite, DuckDB, GeoPackage, PMTiles, NDJSON, Arrow. A dated URL never changes, so use it when the file must stay the same.

Can I open Suburb and locality boundaries in Excel?

Yes. https://publicdata.au/d/sa-suburb-boundaries/v/2026-06-28/data.xlsx is a workbook with the 1,895 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/sa-suburb-boundaries/v/2026-06-28/data.csv.gz is the CSV at about a tenth of the size.

What years does Suburb and locality boundaries cover?

The current version covers 1973 to 2025. Each release from Housing and Urban Development becomes a new dated version here, and earlier versions stay online.

How often is Suburb and locality boundaries updated?

Housing and Urban Development releases it when the publisher updates the layer. This site checks the portal every week and adds a dated version when the file changes.

Can I use Suburb and locality boundaries 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 Suburb and locality boundaries?

No. The publisher is Department for Housing and Urban Development, and its page is https://data.sa.gov.au/data/dataset/suburb-boundaries. 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 coordinate system does Suburb and locality boundaries use?

Shapes in GDA2020 (EPSG:7844), from the GDA2020 layer the publisher ships beside a GDA94 copy. The GeoJSON file uses GDA2020 as well, which differs from the WGS84 GeoJSON expects by well under a metre.

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.

Attribution and citation

The licence requires the publisher's attribution. We ask that you also name publicdata.au and link to the version you used.

Department for Housing and Urban Development, Government of South Australia, Suburbs, https://data.sa.gov.au/data/dataset/suburb-boundaries, accessed 3 October 2026, licensed under CC BY 4.0. Serialised and versioned by National Digital at publicdata.au, https://publicdata.au/d/sa-suburb-boundaries/v/2026-06-28/

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.

Licence record

Department for Housing and Urban Development states the licence, CC BY 4.0, on its own page, which was read and recorded here on 1 October 2026.

Every fetch reads the licence again and stops when it has changed. The fetch that made version 2026-06-28 read it from data.sa.gov.au on 3 October 2026.

Also published on
  • Hugging Faceload_dataset("National-Digital/sa-suburb-boundaries")
  • Kagglewith a starter notebook
  • ZenodoDOI 10.5281/zenodo.23116503

Each copy carries the same attribution and links back to this page.

For agents and tools

This page carries a schema.org Dataset record and is listed in /.well-known/ard.json and /catalog.json.

Source

Department for Housing and Urban Development publishes this table on www.dptiapps.com.au. Questions about the content go to the publisher. Questions about the files here go to corrections.

Fetched 3 October 2026. Source SHA-256 0f19a7dae22e3959…

Improve this dataset

This page is built from register/sa-suburb-boundaries.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