List locations (statistical areas) - Adzuna Intelligence API

Returns a paginated list of all supported locations/statistical areas in our taxonomy.

Example uses for this data include creating a local copy of our location taxonomy, or populating a dropdown in a user interface.

Request

Authorization

Add parameter in header

Authorization

Example:

Authorization: ********************

Path Params

country_code

string

required

A two character code that specifies which country dataset to query.

Example:

Match pattern:

[a-z]{2}

type_pk

integer

required

The unique ID specifying which type of location / statistical areas to return.

Example:

Query Params

page

integer

optional

A specific page of results to return from a paginated dataset.

Default:

Example:

page_size

integer

optional

The number of results to include per page, from a paginated dataset.

Default:

Example:

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Request successful.

application/json

Body

count

integer

optional

The total number of results in the underlying dataset.

Example:

string <uri> | null

optional

The URL to retrieve the next page of results.

Example:

https://api.intelligence.adzuna.com/api/v1.1/gb/location-types/20/locations/?page=4

string <uri> | null

optional

The URL to retrieve the previous page of results.

Example:

https://api.intelligence.adzuna.com/api/v1.1/gb/location-types/20/locations/?page=2

results

array[object (Area) {5}]

optional

An array of locations / statistical areas.

integer

read-onlyrequired

The unique ID of the location / statistical area.

name

string

required

The name of the location / statistical area.

<= 128 characters

code

string

required

The official government code for the location / statistical area.

<= 16 characters

type_id

integer

read-onlyrequired

The unique ID of the location / statistical area type for this location / statistical area.

country_id

integer

read-onlyrequired

The unique ID of the country to which this location / statistical area belongs.

>= -2147483648<= 2147483647

Example

{
  "count": 1,
  "next": "https://api.intelligence.adzuna.com/api/v1.1/gb/location-types/20/locations/?page=4",
  "previous": "https://api.intelligence.adzuna.com/api/v1.1/gb/location-types/20/locations/?page=2",
  "results": [
    {
      "id": 20,
      "name": "North East (England)",
      "code": "TLC",
      "type_id": 20,
      "country_id": 1
    }
  ]
}