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

Liquor licences

GET/v1/suburbs/{suburb_name}/area-stats/liquor-licences3¢ per call

Current liquor licences per suburb by type (pubs, restaurants, bottle shops, clubs, producers), late-night licences and a per-address density, for Victoria and New South Wales.

Coverage: Victoria (as at 31 Aug 2026) and New South Wales (as at 7 Jun 2024). Other states return no data. Current to 2026-08-31. Full description, field list and method: /v1/datasets/liquor-licences.

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: licences_total, pubs_hotels, restaurants_on_premises, bottle_shops, clubs, producers_wholesalers, limited_temporary, other, late_night_3am, licences_per_1000_addresses. 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/liquor-licences

cURL

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

Example Responses

Show schema

{
  "data": {
    "dataset": "liquor-licences",
    "level": "suburb",
    "area": "St Kilda (Vic.)",
    "period_type": "snapshot",
    "as_of": "2026-08-31",
    "modelled": false,
    "fields": [
      {
        "field": "licences_total",
        "name": "Liquor licences",
        "unit": "count",
        "values": [
          {
            "period": "2026-08-31",
            "period_start": "2026-08-31",
            "value": 218
          }
        ]
      },
      {
        "field": "pubs_hotels",
        "name": "Pubs and hotels",
        "unit": "count",
        "values": [
          {
            "period": "2026-08-31",
            "period_start": "2026-08-31",
            "value": 31
          }
        ]
      },
      {
        "field": "restaurants_on_premises",
        "name": "Restaurants, cafes and on-premises venues",
        "unit": "count",
        "values": [
          {
            "period": "2026-08-31",
            "period_start": "2026-08-31",
            "value": 132
          }
        ]
      }
    ]
  }
}

Successful Response200

application/json

About this dataset

Victoria (as at 31 Aug 2026) and New South Wales (as at 7 Jun 2024). Other states return no data. Current to 2026-08-31; refreshed yearly.

What it is

How many licensed premises each suburb has, split by the kind of licence: pubs and hotels, restaurants and on-premises venues, bottle shops, clubs, producers and wholesalers, and temporary licences.

What it shows

The number of current liquor licences in the suburb in total and by type, how many may trade to 3 am or later, and the number of licences per 1,000 addresses.

Why use it

Licence counts are a fast read on a suburb's night-time economy, hospitality precinct, alcohol outlet density and likely noise. They help with commercial site selection, with residential buyers who want a lively strip or a quiet street, and with community-health and planning analysis of outlet density.

How it is built

Each state keeps a public register of liquor licences. We take the Victorian register as at 31 August 2026 and the New South Wales premises list as at 7 June 2024 (the latest openly published), keep current, trading licences, put each premises in the suburb that contains its coordinates, and map each state's licence names onto one common set of types (for example Victoria's 'General licence' and New South Wales' 'Hotel licence' are both pubs and hotels). Premises with no usable location are dropped (about 3% in Victoria, mostly wholesalers). New South Wales is about two years older than Victoria, and the other states publish no register, so they return no data.

Fields

Field	Unit	Description
`licences_total` Liquor licences	count	Current liquor licences of all types for premises in the suburb.
`pubs_hotels` Pubs and hotels	count	General (hotel and tavern) licences, including late-night hotel licences.
`restaurants_on_premises` Restaurants, cafes and on-premises venues	count	Licences to serve alcohol for drinking on the premises: restaurants, cafes, bars and small bars, function venues.
`bottle_shops` Bottle shops	count	Packaged liquor licences (bottle shops and liquor stores).
`clubs` Clubs	count	Licensed clubs, both full and restricted.
`producers_wholesalers` Producers and wholesalers	count	Wineries, breweries, distilleries and wholesalers (producer, pre-retail and wholesale licences).
`limited_temporary` Limited and temporary licences	count	One-off event licences, pop-ups and BYO permits.
`other` Other licences	count	Licences that fit none of the above, such as remote (online and delivery) sellers in Victoria.
`late_night_3am` Authorised to trade to 3 am or later	count	Licences allowed to trade until 3 am or later, including 5 am and 24-hour trading.
`licences_per_1000_addresses` Licences per 1,000 addresses	per 1,000	Licences divided by the suburb's addresses, times 1,000. Returned only for suburbs with 100 or more addresses, because a rate over a handful of addresses is noise.