Free sandbox: try any request below on the sample suburbs, no signup. For every suburb, create an API key.

Microburbs Property Data API

Suburb - Area Statistics

Marital status

GET/v1/suburbs/{suburb_name}/area-stats/marital-status5¢ per call

Who is married, de facto, separated, divorced, widowed or never married, as counts and shares of adults, for every suburb and council area.

Coverage: About 10,500 suburbs and localities and 545 council areas across Australia, in all states and territories (areas with too few people or homes for reliable figures are left out); one snapshot at 10 August 2021. Current to 2021-08-10. Full description, field list and method: /v1/datasets/marital-status.

Exact suburb identifier required. Exact official suburb name (SAL), e.g. Burwood (NSW) — many suburbs carry a state suffix. If starting from free text or an unverified bare name, first call GET /v1/geocode/suburb?q=<text>, then use the exact data[].area_name it returns. Suburb data endpoints do not guess a state or typo-correct names.

Authorization

Bearer tokentest

Sandbox key test works for the allowlisted GNAF + SAL — no signup.

Request

The only values you send. Fields under Responses below are what comes back — you never pass those.

Path parameters

suburb_namestringrequired

Exact official suburb name (SAL), e.g. `Burwood (NSW)` — many suburbs carry a state suffix. If starting from free text or an unverified bare name, first call `GET /v1/geocode/suburb?q=<text>`, then use the exact `data[].area_name` it returns. Suburb data endpoints do not guess a state or typo-correct names.

Query parameters

fieldsstringoptional

Comma-separated subset of: total_aged_15_plus, married_count, married_pct, separated_count, separated_pct, divorced_count, divorced_pct, widowed_count, widowed_pct, never_married_count, never_married_pct, total_in_private_households_15_plus, partnered_registered_marriage_count, partnered_registered_marriage_pct, partnered_de_facto_count, partnered_de_facto_pct, not_partnered_count, not_partnered_pct. Omit for all.

fromstringoptional

First period to include: 2020, 2020-Q3, 2020-07 or 2020-07-01.

tostringoptional

Last period to include, same formats as `from`.

Responses

Successful Response

application/json

DatasetValuesfields returned to you

datasetstringalways returned

Dataset slug; describe it with /v1/datasets/{slug}.

levelstringalways returned

suburb, lga or block.

areastringalways returned

Canonical name (or mesh-block code) of the area answered.

period_typestringalways returned

snapshot, year, financial_year, quarter or month.

as_ofstring · datealways returned

Date the dataset is current to. Values are never withheld for age; check this instead.

modelledbooleanalways returned

True when the figures are estimates from a model rather than counts or measurements.

fieldsarray of DatasetFieldSeriesalways returned

GET/v1/suburbs/{suburb_name}/area-stats/marital-status

cURL

curl --request GET \
  --url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/area-stats/marital-status' \
  --header 'Authorization: Bearer test'

Example Responses

Show schema

{
  "data": {
    "dataset": "marital-status",
    "level": "suburb",
    "area": "Bondi",
    "period_type": "snapshot",
    "as_of": "2021-08-10",
    "modelled": false,
    "fields": [
      {
        "field": "total_aged_15_plus",
        "name": "Residents aged 15 and over",
        "unit": "persons",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 9091
          }
        ]
      },
      {
        "field": "married_count",
        "name": "Married",
        "unit": "persons",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 2583
          }
        ]
      },
      {
        "field": "married_pct",
        "name": "Married: share of residents aged 15 and over",
        "unit": "%",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 28.41
          }
        ]
      }
    ]
  }
}

Successful Response200

application/json

About this dataset

About 10,500 suburbs and localities and 545 council areas across Australia, in all states and territories (areas with too few people or homes for reliable figures are left out); one snapshot at 10 August 2021. Current to 2021-08-10; refreshed five-yearly.

What it is

Two views of partnership for residents aged 15 and over on 10 August 2021, for every suburb and council area: registered marital status (married, separated, divorced, widowed, never married) and social marital status (living with a partner in a registered marriage, in a de facto relationship, or not living with a partner).

What it shows

Registered marital status as a count and a share of residents aged 15 and over, and social marital status as a count and a share of residents aged 15 and over living in private households. Counts and shares are separate fields (for example divorced_count and divorced_pct).

Why use it

Marital status shapes the housing, services and lifestyle a suburb needs: young singles, settled married couples, de facto couples, separated parents and widowed retirees want different things. Use it to target marketing, to plan housing for downsizers and single-person households, to size demand for family law, dating or aged-care services, or to add a relationships profile to a suburb report.

How it is built

Registered status uses all residents aged 15 and over as the base and records legal status, so a divorced person living with a new partner counts as divorced. Social status records the living arrangement; its base is residents aged 15 and over in occupied private dwellings, so people in nursing homes, hostels and other non-private dwellings are not in it. Areas with fewer than 50 people in a base are left out of that part. Our 2021 area statistics, matched to our suburb and council-area names. Figures are a snapshot at 10 August 2021 (the latest full count), so they describe the area then, not today. To protect privacy the source lightly randomises small numbers, so a count of 0, 3 or 6 can be approximate and shares in small areas jump around: check the base field before trusting a percentage. Shares are rounded to two decimals and capped at 100.

Fields

Field	Unit	Description
`total_aged_15_plus` Residents aged 15 and over	persons	All residents aged 15 and over, the base for the registered marital status shares.
`married_count` Married	persons	Number of residents aged 15 and over whose registered marital status is: Married (2021 snapshot). Small counts are lightly randomised for privacy.
`married_pct` Married: share of residents aged 15 and over	%	Married as a percent of all residents aged 15 and over in the area.
`separated_count` Separated (not divorced)	persons	Number of residents aged 15 and over whose registered marital status is: Separated (not divorced) (2021 snapshot). Small counts are lightly randomised for privacy.
`separated_pct` Separated (not divorced): share of residents aged 15 and over	%	Separated (not divorced) as a percent of all residents aged 15 and over in the area.
`divorced_count` Divorced	persons	Number of residents aged 15 and over whose registered marital status is: Divorced (2021 snapshot). Small counts are lightly randomised for privacy.
`divorced_pct` Divorced: share of residents aged 15 and over	%	Divorced as a percent of all residents aged 15 and over in the area.
`widowed_count` Widowed	persons	Number of residents aged 15 and over whose registered marital status is: Widowed (2021 snapshot). Small counts are lightly randomised for privacy.
`widowed_pct` Widowed: share of residents aged 15 and over	%	Widowed as a percent of all residents aged 15 and over in the area.
`never_married_count` Never married	persons	Number of residents aged 15 and over whose registered marital status is: Never married (2021 snapshot). Small counts are lightly randomised for privacy.
`never_married_pct` Never married: share of residents aged 15 and over	%	Never married as a percent of all residents aged 15 and over in the area.
`total_in_private_households_15_plus` Residents aged 15 and over in private households	persons	Residents aged 15 and over living in occupied private dwellings, the base for the social marital status shares.
`partnered_registered_marriage_count` Living with a partner in a registered marriage	persons	Number of residents aged 15 and over in private households who are: Living with a partner in a registered marriage (2021 snapshot). Small counts are lightly randomised for privacy.
`partnered_registered_marriage_pct` Living with a partner in a registered marriage: share of residents aged 15 and over in private households	%	Living with a partner in a registered marriage as a percent of all residents aged 15 and over in private households in the area.
`partnered_de_facto_count` Living with a partner in a de facto relationship	persons	Number of residents aged 15 and over in private households who are: Living with a partner in a de facto relationship (2021 snapshot). Small counts are lightly randomised for privacy.
`partnered_de_facto_pct` Living with a partner in a de facto relationship: share of residents aged 15 and over in private households	%	Living with a partner in a de facto relationship as a percent of all residents aged 15 and over in private households in the area.
`not_partnered_count` Not living with a partner	persons	Number of residents aged 15 and over in private households who are: Not living with a partner (2021 snapshot). Small counts are lightly randomised for privacy.
`not_partnered_pct` Not living with a partner: share of residents aged 15 and over in private households	%	Not living with a partner as a percent of all residents aged 15 and over in private households in the area.