---
title: "Get local population demographics data"
method: GET
path: "/demographics"
---

# Get local population demographics data

`GET /demographics`

## Request

- Base URL: `https://api.propertydata.co.uk`
- URL: `https://api.propertydata.co.uk/demographics`
- Auth: HTTP bearer

Costs 1 credit per call. Coverage: England and Wales only, not Scotland or Northern Ireland.

## Query parameters

- `postcode` string
- `location` string
- `town` string

## Response `200`

Successful response

- object
  - `status` string
  - `postcode` string
  - `postcode_type` string
  - `url` string
  - `output_area_count` integer
  - `output_area` string
  - `data` object
    - `deprivation` integer
    - `health` integer
    - `social_grade` object
    - `age` object
    - `politics` object
      - `results` object
        - `Labour` string
        - `Conservative` string
        - `Liberal Democrat` string
        - `Reform UK` string
        - `Green` string
        - `Other` string
      - `constituences` string[]
    - `proportion_with_degree` integer
    - `vehicles_per_household` string
    - `commute_method` object
      - `at_home` string
      - `underground_light_rail` string
      - `train` string
      - `bus` string
      - `taxi` string
      - `motorcycle` string
      - `car_driver` string
      - `car_passenger` string
      - `bicycle` string
      - `foot` string
      - `other` string
  - `process_time` string: Server processing time in seconds

## Other responses

- `4XX`: Error response. Common codes: X02 missing key (400), X03 invalid key (422), X04 credit limit exceeded (403), X06/X07 missing or invalid location input (400/422), X08 insufficient data for location (404), X13 free trial limit exceeded (403), X14 rate limited (429), X20 server busy, retry after 60 seconds (503).

---

[API](https://skmtc.dev/propertydata/apis/propertydata-api.md) · [All operations](https://skmtc.dev/propertydata/apis/propertydata-api/llms.txt) · [OpenAPI document](https://skmtc.dev/propertydata/apis/propertydata-api/revisions/38ab011f2f4c?raw)