Microburbs
Free sandbox: try any request below on the sample suburbs, no signup. For every suburb, create an API key.
Classic docs
Microburbs Property Data API
Suburb - Area Statistics

Income by religion

GET/v1/suburbs/{suburb_name}/area-stats/income-by-religion10¢ per call

How much each religious group earns: weekly personal income bands for seven religion groups, in every suburb and council area.

Coverage: About 11,300 suburbs and localities and 545 council areas across Australia, in all states and territories (areas with too few residents 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/income-by-religion.

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

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: all_income_stated, all_under_500_pct, all_500_to_999_pct, all_1000_to_1999_pct, all_2000_plus_pct, buddhism_income_stated, buddhism_under_500_count, buddhism_under_500_pct, buddhism_500_to_999_count, buddhism_500_to_999_pct, buddhism_1000_to_1999_count, buddhism_1000_to_1999_pct, buddhism_2000_plus_count, buddhism_2000_plus_pct, christianity_income_stated, christianity_under_500_count, christianity_under_500_pct, christianity_500_to_999_count, christianity_500_to_999_pct, christianity_1000_to_1999_count, christianity_1000_to_1999_pct, christianity_2000_plus_count, christianity_2000_plus_pct, hinduism_income_stated, hinduism_under_500_count, hinduism_under_500_pct, hinduism_500_to_999_count, hinduism_500_to_999_pct, hinduism_1000_to_1999_count, hinduism_1000_to_1999_pct, hinduism_2000_plus_count, hinduism_2000_plus_pct, islam_income_stated, islam_under_500_count, islam_under_500_pct, islam_500_to_999_count, islam_500_to_999_pct, islam_1000_to_1999_count, islam_1000_to_1999_pct, islam_2000_plus_count, islam_2000_plus_pct, judaism_income_stated, judaism_under_500_count, judaism_under_500_pct, judaism_500_to_999_count, judaism_500_to_999_pct, judaism_1000_to_1999_count, judaism_1000_to_1999_pct, judaism_2000_plus_count, judaism_2000_plus_pct, other_religions_income_stated, other_religions_under_500_count, other_religions_under_500_pct, other_religions_500_to_999_count, other_religions_500_to_999_pct, other_religions_1000_to_1999_count, other_religions_1000_to_1999_pct, other_religions_2000_plus_count, other_religions_2000_plus_pct, no_religion_income_stated, no_religion_under_500_count, no_religion_under_500_pct, no_religion_500_to_999_count, no_religion_500_to_999_pct, no_religion_1000_to_1999_count, no_religion_1000_to_1999_pct, no_religion_2000_plus_count, no_religion_2000_plus_pct, buddhism_share_of_top_earners_pct, christianity_share_of_top_earners_pct, hinduism_share_of_top_earners_pct, islam_share_of_top_earners_pct, judaism_share_of_top_earners_pct, other_religions_share_of_top_earners_pct, no_religion_share_of_top_earners_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/income-by-religion
cURL
curl --request GET \
  --url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/area-stats/income-by-religion' \
  --header 'Authorization: Bearer test'
Example Responses
{
  "data": {
    "dataset": "income-by-religion",
    "level": "suburb",
    "area": "Bondi",
    "period_type": "snapshot",
    "as_of": "2021-08-10",
    "modelled": false,
    "fields": [
      {
        "field": "all_income_stated",
        "name": "All residents aged 15+ with income stated",
        "unit": "persons",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 6519
          }
        ]
      },
      {
        "field": "all_under_500_pct",
        "name": "All residents: weekly income under $500 a week",
        "unit": "%",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 13.3
          }
        ]
      },
      {
        "field": "all_500_to_999_pct",
        "name": "All residents: weekly income $500 to $999 a week",
        "unit": "%",
        "values": [
          {
            "period": "2021-08-10",
            "period_start": "2021-08-10",
            "value": 18.19
          }
        ]
      }
    ]
  }
}
Successful Response200
application/json

About this dataset

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

What it is

A cross of religion and personal income. For residents aged 15 and over, it counts how many people in each of seven religious groups (Buddhism, Christianity, Hinduism, Islam, Judaism, other religions, no religion) earn under $500, $500-$999, $1,000-$1,999 or $2,000+ a week before tax, in every suburb and council area, with shares and each group's share of the area's top earners.

What it shows

For each religion: how many residents have income stated, how many are in each of four weekly income bands (count and share within that religion), and the group's share of residents earning $2,000+ a week. Plus the whole-area income mix (all_*) as the benchmark.

Why use it

Income differs sharply between communities even in the same suburb. Use it to size the spending power of a faith community, to target community banking, education or retail offers, to compare a group's income with the area average, or to see which communities are over- or under-represented among high earners. For the plain religion mix see religion.

How it is built

Our 2021 area statistics: a personal-income by religion table counted for small blocks and summed up to each suburb and council area (no block-level figures are published). Snapshot at 10 August 2021. Income is gross weekly personal income of residents aged 15+; people with income or religion not stated are left out, so the "all" benchmark covers only residents who stated both. The source lightly randomises small block counts, so small groups (a few dozen people) are approximate and their percentages jump; check the group's income_stated count before quoting a share. Religion groups follow the broad (one-digit) classification.

Fields

FieldUnitDescription
all_income_stated
All residents aged 15+ with income stated
personsResidents aged 15 and over who stated their weekly personal income, across every group. The base for the 'all' shares.
all_under_500_pct
All residents: weekly income under $500 a week
%Percent of all residents aged 15+ (income stated) whose weekly personal income is under $500 a week. The area-wide benchmark to compare each religion against.
all_500_to_999_pct
All residents: weekly income $500 to $999 a week
%Percent of all residents aged 15+ (income stated) whose weekly personal income is $500 to $999 a week. The area-wide benchmark to compare each religion against.
all_1000_to_1999_pct
All residents: weekly income $1,000 to $1,999 a week
%Percent of all residents aged 15+ (income stated) whose weekly personal income is $1,000 to $1,999 a week. The area-wide benchmark to compare each religion against.
all_2000_plus_pct
All residents: weekly income $2,000 a week or more
%Percent of all residents aged 15+ (income stated) whose weekly personal income is $2,000 a week or more. The area-wide benchmark to compare each religion against.
buddhism_income_stated
Buddhism: residents aged 15+ with income stated
personsResidents aged 15 and over in this religion group (Buddhism) who stated their weekly personal income. The base for the group's shares.
buddhism_under_500_count
Buddhism: weekly income under $500 a week
personsResidents aged 15+ in the Buddhism group whose weekly personal income (before tax) is under $500 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
buddhism_under_500_pct
Buddhism: share with weekly income under $500 a week
%Percent of the Buddhism group (aged 15+, income stated) whose weekly personal income is under $500 a week.
buddhism_500_to_999_count
Buddhism: weekly income $500 to $999 a week
personsResidents aged 15+ in the Buddhism group whose weekly personal income (before tax) is $500 to $999 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
buddhism_500_to_999_pct
Buddhism: share with weekly income $500 to $999 a week
%Percent of the Buddhism group (aged 15+, income stated) whose weekly personal income is $500 to $999 a week.
buddhism_1000_to_1999_count
Buddhism: weekly income $1,000 to $1,999 a week
personsResidents aged 15+ in the Buddhism group whose weekly personal income (before tax) is $1,000 to $1,999 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
buddhism_1000_to_1999_pct
Buddhism: share with weekly income $1,000 to $1,999 a week
%Percent of the Buddhism group (aged 15+, income stated) whose weekly personal income is $1,000 to $1,999 a week.
buddhism_2000_plus_count
Buddhism: weekly income $2,000 a week or more
personsResidents aged 15+ in the Buddhism group whose weekly personal income (before tax) is $2,000 a week or more. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
buddhism_2000_plus_pct
Buddhism: share with weekly income $2,000 a week or more
%Percent of the Buddhism group (aged 15+, income stated) whose weekly personal income is $2,000 a week or more.
christianity_income_stated
Christianity: residents aged 15+ with income stated
personsResidents aged 15 and over in this religion group (Christianity) who stated their weekly personal income. The base for the group's shares.
christianity_under_500_count
Christianity: weekly income under $500 a week
personsResidents aged 15+ in the Christianity group whose weekly personal income (before tax) is under $500 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
christianity_under_500_pct
Christianity: share with weekly income under $500 a week
%Percent of the Christianity group (aged 15+, income stated) whose weekly personal income is under $500 a week.
christianity_500_to_999_count
Christianity: weekly income $500 to $999 a week
personsResidents aged 15+ in the Christianity group whose weekly personal income (before tax) is $500 to $999 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
christianity_500_to_999_pct
Christianity: share with weekly income $500 to $999 a week
%Percent of the Christianity group (aged 15+, income stated) whose weekly personal income is $500 to $999 a week.
christianity_1000_to_1999_count
Christianity: weekly income $1,000 to $1,999 a week
personsResidents aged 15+ in the Christianity group whose weekly personal income (before tax) is $1,000 to $1,999 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
christianity_1000_to_1999_pct
Christianity: share with weekly income $1,000 to $1,999 a week
%Percent of the Christianity group (aged 15+, income stated) whose weekly personal income is $1,000 to $1,999 a week.
christianity_2000_plus_count
Christianity: weekly income $2,000 a week or more
personsResidents aged 15+ in the Christianity group whose weekly personal income (before tax) is $2,000 a week or more. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
christianity_2000_plus_pct
Christianity: share with weekly income $2,000 a week or more
%Percent of the Christianity group (aged 15+, income stated) whose weekly personal income is $2,000 a week or more.
hinduism_income_stated
Hinduism: residents aged 15+ with income stated
personsResidents aged 15 and over in this religion group (Hinduism) who stated their weekly personal income. The base for the group's shares.
hinduism_under_500_count
Hinduism: weekly income under $500 a week
personsResidents aged 15+ in the Hinduism group whose weekly personal income (before tax) is under $500 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
hinduism_under_500_pct
Hinduism: share with weekly income under $500 a week
%Percent of the Hinduism group (aged 15+, income stated) whose weekly personal income is under $500 a week.
hinduism_500_to_999_count
Hinduism: weekly income $500 to $999 a week
personsResidents aged 15+ in the Hinduism group whose weekly personal income (before tax) is $500 to $999 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
hinduism_500_to_999_pct
Hinduism: share with weekly income $500 to $999 a week
%Percent of the Hinduism group (aged 15+, income stated) whose weekly personal income is $500 to $999 a week.
hinduism_1000_to_1999_count
Hinduism: weekly income $1,000 to $1,999 a week
personsResidents aged 15+ in the Hinduism group whose weekly personal income (before tax) is $1,000 to $1,999 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
hinduism_1000_to_1999_pct
Hinduism: share with weekly income $1,000 to $1,999 a week
%Percent of the Hinduism group (aged 15+, income stated) whose weekly personal income is $1,000 to $1,999 a week.
hinduism_2000_plus_count
Hinduism: weekly income $2,000 a week or more
personsResidents aged 15+ in the Hinduism group whose weekly personal income (before tax) is $2,000 a week or more. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
hinduism_2000_plus_pct
Hinduism: share with weekly income $2,000 a week or more
%Percent of the Hinduism group (aged 15+, income stated) whose weekly personal income is $2,000 a week or more.
islam_income_stated
Islam: residents aged 15+ with income stated
personsResidents aged 15 and over in this religion group (Islam) who stated their weekly personal income. The base for the group's shares.
islam_under_500_count
Islam: weekly income under $500 a week
personsResidents aged 15+ in the Islam group whose weekly personal income (before tax) is under $500 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
islam_under_500_pct
Islam: share with weekly income under $500 a week
%Percent of the Islam group (aged 15+, income stated) whose weekly personal income is under $500 a week.
islam_500_to_999_count
Islam: weekly income $500 to $999 a week
personsResidents aged 15+ in the Islam group whose weekly personal income (before tax) is $500 to $999 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
islam_500_to_999_pct
Islam: share with weekly income $500 to $999 a week
%Percent of the Islam group (aged 15+, income stated) whose weekly personal income is $500 to $999 a week.
islam_1000_to_1999_count
Islam: weekly income $1,000 to $1,999 a week
personsResidents aged 15+ in the Islam group whose weekly personal income (before tax) is $1,000 to $1,999 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
islam_1000_to_1999_pct
Islam: share with weekly income $1,000 to $1,999 a week
%Percent of the Islam group (aged 15+, income stated) whose weekly personal income is $1,000 to $1,999 a week.
islam_2000_plus_count
Islam: weekly income $2,000 a week or more
personsResidents aged 15+ in the Islam group whose weekly personal income (before tax) is $2,000 a week or more. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
islam_2000_plus_pct
Islam: share with weekly income $2,000 a week or more
%Percent of the Islam group (aged 15+, income stated) whose weekly personal income is $2,000 a week or more.
judaism_income_stated
Judaism: residents aged 15+ with income stated
personsResidents aged 15 and over in this religion group (Judaism) who stated their weekly personal income. The base for the group's shares.
judaism_under_500_count
Judaism: weekly income under $500 a week
personsResidents aged 15+ in the Judaism group whose weekly personal income (before tax) is under $500 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
judaism_under_500_pct
Judaism: share with weekly income under $500 a week
%Percent of the Judaism group (aged 15+, income stated) whose weekly personal income is under $500 a week.
judaism_500_to_999_count
Judaism: weekly income $500 to $999 a week
personsResidents aged 15+ in the Judaism group whose weekly personal income (before tax) is $500 to $999 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
judaism_500_to_999_pct
Judaism: share with weekly income $500 to $999 a week
%Percent of the Judaism group (aged 15+, income stated) whose weekly personal income is $500 to $999 a week.
judaism_1000_to_1999_count
Judaism: weekly income $1,000 to $1,999 a week
personsResidents aged 15+ in the Judaism group whose weekly personal income (before tax) is $1,000 to $1,999 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
judaism_1000_to_1999_pct
Judaism: share with weekly income $1,000 to $1,999 a week
%Percent of the Judaism group (aged 15+, income stated) whose weekly personal income is $1,000 to $1,999 a week.
judaism_2000_plus_count
Judaism: weekly income $2,000 a week or more
personsResidents aged 15+ in the Judaism group whose weekly personal income (before tax) is $2,000 a week or more. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
judaism_2000_plus_pct
Judaism: share with weekly income $2,000 a week or more
%Percent of the Judaism group (aged 15+, income stated) whose weekly personal income is $2,000 a week or more.
other_religions_income_stated
Other religions: residents aged 15+ with income stated
personsResidents aged 15 and over in this religion group (Other religions) who stated their weekly personal income. The base for the group's shares.
other_religions_under_500_count
Other religions: weekly income under $500 a week
personsResidents aged 15+ in the Other religions group whose weekly personal income (before tax) is under $500 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
other_religions_under_500_pct
Other religions: share with weekly income under $500 a week
%Percent of the Other religions group (aged 15+, income stated) whose weekly personal income is under $500 a week.
other_religions_500_to_999_count
Other religions: weekly income $500 to $999 a week
personsResidents aged 15+ in the Other religions group whose weekly personal income (before tax) is $500 to $999 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
other_religions_500_to_999_pct
Other religions: share with weekly income $500 to $999 a week
%Percent of the Other religions group (aged 15+, income stated) whose weekly personal income is $500 to $999 a week.
other_religions_1000_to_1999_count
Other religions: weekly income $1,000 to $1,999 a week
personsResidents aged 15+ in the Other religions group whose weekly personal income (before tax) is $1,000 to $1,999 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
other_religions_1000_to_1999_pct
Other religions: share with weekly income $1,000 to $1,999 a week
%Percent of the Other religions group (aged 15+, income stated) whose weekly personal income is $1,000 to $1,999 a week.
other_religions_2000_plus_count
Other religions: weekly income $2,000 a week or more
personsResidents aged 15+ in the Other religions group whose weekly personal income (before tax) is $2,000 a week or more. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
other_religions_2000_plus_pct
Other religions: share with weekly income $2,000 a week or more
%Percent of the Other religions group (aged 15+, income stated) whose weekly personal income is $2,000 a week or more.
no_religion_income_stated
No religion or secular beliefs: residents aged 15+ with income stated
personsResidents aged 15 and over in this religion group (No religion or secular beliefs) who stated their weekly personal income. The base for the group's shares.
no_religion_under_500_count
No religion or secular beliefs: weekly income under $500 a week
personsResidents aged 15+ in the No religion or secular beliefs group whose weekly personal income (before tax) is under $500 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
no_religion_under_500_pct
No religion or secular beliefs: share with weekly income under $500 a week
%Percent of the No religion or secular beliefs group (aged 15+, income stated) whose weekly personal income is under $500 a week.
no_religion_500_to_999_count
No religion or secular beliefs: weekly income $500 to $999 a week
personsResidents aged 15+ in the No religion or secular beliefs group whose weekly personal income (before tax) is $500 to $999 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
no_religion_500_to_999_pct
No religion or secular beliefs: share with weekly income $500 to $999 a week
%Percent of the No religion or secular beliefs group (aged 15+, income stated) whose weekly personal income is $500 to $999 a week.
no_religion_1000_to_1999_count
No religion or secular beliefs: weekly income $1,000 to $1,999 a week
personsResidents aged 15+ in the No religion or secular beliefs group whose weekly personal income (before tax) is $1,000 to $1,999 a week. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
no_religion_1000_to_1999_pct
No religion or secular beliefs: share with weekly income $1,000 to $1,999 a week
%Percent of the No religion or secular beliefs group (aged 15+, income stated) whose weekly personal income is $1,000 to $1,999 a week.
no_religion_2000_plus_count
No religion or secular beliefs: weekly income $2,000 a week or more
personsResidents aged 15+ in the No religion or secular beliefs group whose weekly personal income (before tax) is $2,000 a week or more. Summed from small blocks whose counts are lightly randomised for privacy, so read small numbers as approximate.
no_religion_2000_plus_pct
No religion or secular beliefs: share with weekly income $2,000 a week or more
%Percent of the No religion or secular beliefs group (aged 15+, income stated) whose weekly personal income is $2,000 a week or more.
buddhism_share_of_top_earners_pct
Buddhism: share of residents earning $2,000+ a week
%Of all residents aged 15+ in the area who earn $2,000 a week or more, the percent who belong to the Buddhism group. Compare with the group's share of all residents (see the religion dataset) to see whether it is over- or under-represented among high earners.
christianity_share_of_top_earners_pct
Christianity: share of residents earning $2,000+ a week
%Of all residents aged 15+ in the area who earn $2,000 a week or more, the percent who belong to the Christianity group. Compare with the group's share of all residents (see the religion dataset) to see whether it is over- or under-represented among high earners.
hinduism_share_of_top_earners_pct
Hinduism: share of residents earning $2,000+ a week
%Of all residents aged 15+ in the area who earn $2,000 a week or more, the percent who belong to the Hinduism group. Compare with the group's share of all residents (see the religion dataset) to see whether it is over- or under-represented among high earners.
islam_share_of_top_earners_pct
Islam: share of residents earning $2,000+ a week
%Of all residents aged 15+ in the area who earn $2,000 a week or more, the percent who belong to the Islam group. Compare with the group's share of all residents (see the religion dataset) to see whether it is over- or under-represented among high earners.
judaism_share_of_top_earners_pct
Judaism: share of residents earning $2,000+ a week
%Of all residents aged 15+ in the area who earn $2,000 a week or more, the percent who belong to the Judaism group. Compare with the group's share of all residents (see the religion dataset) to see whether it is over- or under-represented among high earners.
other_religions_share_of_top_earners_pct
Other religions: share of residents earning $2,000+ a week
%Of all residents aged 15+ in the area who earn $2,000 a week or more, the percent who belong to the Other religions group. Compare with the group's share of all residents (see the religion dataset) to see whether it is over- or under-represented among high earners.
no_religion_share_of_top_earners_pct
No religion or secular beliefs: share of residents earning $2,000+ a week
%Of all residents aged 15+ in the area who earn $2,000 a week or more, the percent who belong to the No religion or secular beliefs group. Compare with the group's share of all residents (see the religion dataset) to see whether it is over- or under-represented among high earners.