Long-term health conditions
/v1/suburbs/{suburb_name}/area-stats/health-conditions5¢ per callHow many residents live with arthritis, asthma, cancer, dementia, diabetes, heart disease, a mental health condition, stroke and other long-term conditions, and how many have more than one, for every suburb and council area.
Coverage: About 11,000 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/health-conditions.
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_namestringrequiredExact 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
fieldsstringoptionalComma-separated subset of: total_population, arthritis_count, arthritis_pct, asthma_count, asthma_pct, cancer_count, cancer_pct, dementia_count, dementia_pct, diabetes_count, diabetes_pct, heart_disease_count, heart_disease_pct, kidney_disease_count, kidney_disease_pct, lung_condition_count, lung_condition_pct, mental_health_condition_count, mental_health_condition_pct, stroke_count, stroke_pct, other_condition_count, other_condition_pct, no_condition_count, no_condition_pct, any_named_condition_count, any_named_condition_pct, no_named_condition_count, no_named_condition_pct, one_named_condition_count, one_named_condition_pct, two_named_conditions_count, two_named_conditions_pct, three_plus_named_conditions_count, three_plus_named_conditions_pct, not_stated_count, not_stated_pct. Omit for all.
fromstringoptionalFirst period to include: 2020, 2020-Q3, 2020-07 or 2020-07-01.
tostringoptionalLast period to include, same formats as `from`.
Responses
Successful Response
datasetstringalways returnedDataset slug; describe it with /v1/datasets/{slug}.
levelstringalways returnedsuburb, lga or block.
areastringalways returnedCanonical name (or mesh-block code) of the area answered.
period_typestringalways returnedsnapshot, year, financial_year, quarter or month.
as_ofstring · datealways returnedDate the dataset is current to. Values are never withheld for age; check this instead.
modelledbooleanalways returnedTrue when the figures are estimates from a model rather than counts or measurements.
fieldsarray of DatasetFieldSeriesalways returned/v1/suburbs/{suburb_name}/area-stats/health-conditionscurl --request GET \
--url 'https://api.microburbs.com.au/v1/suburbs/Belmont%20North/area-stats/health-conditions' \
--header 'Authorization: Bearer test'{
"data": {
"dataset": "health-conditions",
"level": "suburb",
"area": "Bondi",
"period_type": "snapshot",
"as_of": "2021-08-10",
"modelled": false,
"fields": [
{
"field": "total_population",
"name": "Total residents",
"unit": "persons",
"values": [
{
"period": "2021-08-10",
"period_start": "2021-08-10",
"value": 10411
}
]
},
{
"field": "arthritis_count",
"name": "Arthritis",
"unit": "persons",
"values": [
{
"period": "2021-08-10",
"period_start": "2021-08-10",
"value": 473
}
]
},
{
"field": "arthritis_pct",
"name": "Arthritis: share of residents",
"unit": "%",
"values": [
{
"period": "2021-08-10",
"period_start": "2021-08-10",
"value": 4.54
}
]
}
]
}
}About this dataset
About 11,000 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
Long-term health conditions residents reported on 10 August 2021, for every suburb and council area: ten named conditions (arthritis, asthma, cancer, dementia including Alzheimer's, diabetes, heart disease, kidney disease, lung conditions such as COPD, mental health conditions such as depression or anxiety, and stroke), any other long-term condition, no condition, and how many of the named conditions each person has.
What it shows
Residents with each condition, and residents by number of named conditions (none, one, two, three or more, and any), each as a head-count and as a share of all residents, plus the total. Counts and shares are separate fields (for example diabetes_count and diabetes_pct). A person with several conditions is counted under each, so the condition shares add to more than 100.
Why use it
Health needs drive demand for GPs, specialists, pharmacies, allied health, aged care and disability services. Use it to find suburbs with high rates of diabetes, heart disease or mental health conditions, to place a clinic, pharmacy or support service, to plan health programs and outreach, to see how an area's needs compare with its council area, or to add a health profile to a suburb report.
How it is built
Conditions are self-reported: a condition diagnosed by a doctor or nurse that has lasted, or is expected to last, six months or more. The base is all residents, including those who did not answer (not_stated). Older areas have more of most conditions simply because of age, so compare similar areas or read with the age profile. no_condition means no long-term condition at all; no_named_condition means none of the ten named ones (it includes people with only another condition). Areas with fewer than 50 residents are left out. 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_populationTotal residents | persons | All residents counted in the area on 10 August 2021, the base for every share. |
arthritis_countArthritis | persons | Number of residents in the area reporting: Arthritis (2021 snapshot). Small counts are lightly randomised for privacy. |
arthritis_pctArthritis: share of residents | % | Arthritis as a percent of all residents in the area. |
asthma_countAsthma | persons | Number of residents in the area reporting: Asthma (2021 snapshot). Small counts are lightly randomised for privacy. |
asthma_pctAsthma: share of residents | % | Asthma as a percent of all residents in the area. |
cancer_countCancer (including remission) | persons | Number of residents in the area reporting: Cancer (including remission) (2021 snapshot). Small counts are lightly randomised for privacy. |
cancer_pctCancer (including remission): share of residents | % | Cancer (including remission) as a percent of all residents in the area. |
dementia_countDementia (including Alzheimer's) | persons | Number of residents in the area reporting: Dementia (including Alzheimer's) (2021 snapshot). Small counts are lightly randomised for privacy. |
dementia_pctDementia (including Alzheimer's): share of residents | % | Dementia (including Alzheimer's) as a percent of all residents in the area. |
diabetes_countDiabetes (excluding gestational diabetes) | persons | Number of residents in the area reporting: Diabetes (excluding gestational diabetes) (2021 snapshot). Small counts are lightly randomised for privacy. |
diabetes_pctDiabetes (excluding gestational diabetes): share of residents | % | Diabetes (excluding gestational diabetes) as a percent of all residents in the area. |
heart_disease_countHeart disease (including heart attack or angina) | persons | Number of residents in the area reporting: Heart disease (including heart attack or angina) (2021 snapshot). Small counts are lightly randomised for privacy. |
heart_disease_pctHeart disease (including heart attack or angina): share of residents | % | Heart disease (including heart attack or angina) as a percent of all residents in the area. |
kidney_disease_countKidney disease | persons | Number of residents in the area reporting: Kidney disease (2021 snapshot). Small counts are lightly randomised for privacy. |
kidney_disease_pctKidney disease: share of residents | % | Kidney disease as a percent of all residents in the area. |
lung_condition_countLung condition (including COPD or emphysema) | persons | Number of residents in the area reporting: Lung condition (including COPD or emphysema) (2021 snapshot). Small counts are lightly randomised for privacy. |
lung_condition_pctLung condition (including COPD or emphysema): share of residents | % | Lung condition (including COPD or emphysema) as a percent of all residents in the area. |
mental_health_condition_countMental health condition (including depression or anxiety) | persons | Number of residents in the area reporting: Mental health condition (including depression or anxiety) (2021 snapshot). Small counts are lightly randomised for privacy. |
mental_health_condition_pctMental health condition (including depression or anxiety): share of residents | % | Mental health condition (including depression or anxiety) as a percent of all residents in the area. |
stroke_countStroke | persons | Number of residents in the area reporting: Stroke (2021 snapshot). Small counts are lightly randomised for privacy. |
stroke_pctStroke: share of residents | % | Stroke as a percent of all residents in the area. |
other_condition_countAny other long-term health condition | persons | Number of residents in the area reporting: Any other long-term health condition (2021 snapshot). Small counts are lightly randomised for privacy. |
other_condition_pctAny other long-term health condition: share of residents | % | Any other long-term health condition as a percent of all residents in the area. |
no_condition_countNo long-term health condition | persons | Number of residents in the area reporting: No long-term health condition (2021 snapshot). Small counts are lightly randomised for privacy. |
no_condition_pctNo long-term health condition: share of residents | % | No long-term health condition as a percent of all residents in the area. |
any_named_condition_countOne or more of the ten named conditions | persons | Number of residents in the area reporting: One or more of the ten named conditions (2021 snapshot). Small counts are lightly randomised for privacy. |
any_named_condition_pctOne or more of the ten named conditions: share of residents | % | One or more of the ten named conditions as a percent of all residents in the area. |
no_named_condition_countNone of the ten named conditions | persons | Number of residents in the area reporting: None of the ten named conditions (2021 snapshot). Small counts are lightly randomised for privacy. |
no_named_condition_pctNone of the ten named conditions: share of residents | % | None of the ten named conditions as a percent of all residents in the area. |
one_named_condition_countExactly one of the named conditions | persons | Number of residents in the area reporting: Exactly one of the named conditions (2021 snapshot). Small counts are lightly randomised for privacy. |
one_named_condition_pctExactly one of the named conditions: share of residents | % | Exactly one of the named conditions as a percent of all residents in the area. |
two_named_conditions_countTwo of the named conditions | persons | Number of residents in the area reporting: Two of the named conditions (2021 snapshot). Small counts are lightly randomised for privacy. |
two_named_conditions_pctTwo of the named conditions: share of residents | % | Two of the named conditions as a percent of all residents in the area. |
three_plus_named_conditions_countThree or more of the named conditions | persons | Number of residents in the area reporting: Three or more of the named conditions (2021 snapshot). Small counts are lightly randomised for privacy. |
three_plus_named_conditions_pctThree or more of the named conditions: share of residents | % | Three or more of the named conditions as a percent of all residents in the area. |
not_stated_countHealth conditions not stated | persons | Number of residents in the area reporting: Health conditions not stated (2021 snapshot). Small counts are lightly randomised for privacy. |
not_stated_pctHealth conditions not stated: share of residents | % | Health conditions not stated as a percent of all residents in the area. |