# Get City

Returns a city for a given city ID number. Note that a unique identification number is allocated to each city included
in the DIDWW coverage.

## Request

HTTP Method: `GET`

URI Path: `/v3/cities/{id}`

Note

For all returned data attributes, see [City Object](city-object.html).

### URI Query Parameters

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| id | `string` | Yes | Unique ID identifier of the City. |
| include | `string` | No | [Inclusion](../../../specification/includes.html#api-includes) |

### Includes

| Value | Description |
| --- | --- |
| country | [Country Object](../countries/country-object.html#country-object-v35) |
| region | [Region Object](../regions/region-object.html#region-object-v35) |
| area | [Area Object](../../regulation-resources/areas/area-object.html#area-object-v35) |

## Examples

Simple RequestInclude Country

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/cities/cdf449bc-e3fb-42cc-bf31-b88f91e40de4 HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]
```

curl

```
1curl -i -X GET https://api.didww.com/v3/cities/cdf449bc-e3fb-42cc-bf31-b88f91e40de4 -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"
```

response

```
 1HTTP/1.1 200 OK
 2Content-Type: application/vnd.api+json
 3
 4{
 5  "data": {
 6    "id": "cdf449bc-e3fb-42cc-bf31-b88f91e40de4",
 7    "type": "cities",
 8    "attributes": {
 9      "name": "London"
10    },
11    "relationships": {
12      "country": {
13        "links": {
14          "self": "https://api.didww.com/v3/cities/cdf449bc-e3fb-42cc-bf31-b88f91e40de4/relationships/country",
15          "related": "https://api.didww.com/v3/cities/cdf449bc-e3fb-42cc-bf31-b88f91e40de4/country"
16        }
17      },
18      "region": {
19        "links": {
20          "self": "https://api.didww.com/v3/cities/cdf449bc-e3fb-42cc-bf31-b88f91e40de4/relationships/region",
21          "related": "https://api.didww.com/v3/cities/cdf449bc-e3fb-42cc-bf31-b88f91e40de4/region"
22        }
23      },
24      "area": {
25        "links": {
26          "self": "https://api.didww.com/v3/cities/cdf449bc-e3fb-42cc-bf31-b88f91e40de4/relationships/area",
27          "related": "https://api.didww.com/v3/cities/cdf449bc-e3fb-42cc-bf31-b88f91e40de4/area"
28        }
29      }
30    }
31  },
32  "meta": {
33    "api_version": "2026-11-19"
34  }
35}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/cities/498f2880-591f-436d-aacd-46ad3a7d8be8?include=country HTTP/1.1
2Host: api.didww.com
3Content-Type: application/vnd.api+json
4Accept: application/vnd.api+json
5Authorization: Bearer [access token]
```

curl

```
1curl -i -X GET 'https://api.didww.com/v3/cities/498f2880-591f-436d-aacd-46ad3a7d8be8?include=country' -H "Accept: application/vnd.api+json" -H "Content-Type: application/vnd.api+json" -H "Authorization: Bearer [access token]"
```

response

```
 1HTTP/1.1 200 OK
 2Content-Type: application/vnd.api+json
 3
 4{
 5  "data": {
 6    "id": "498f2880-591f-436d-aacd-46ad3a7d8be8",
 7    "type": "cities",
 8    "attributes": {
 9      "name": "London"
10    },
11    "relationships": {
12      "country": {
13        "links": {
14          "self": "https://api.didww.com/v3/cities/498f2880-591f-436d-aacd-46ad3a7d8be8/relationships/country",
15          "related": "https://api.didww.com/v3/cities/498f2880-591f-436d-aacd-46ad3a7d8be8/country"
16        },
17        "data": {
18          "type": "countries",
19          "id": "2e89d524-55b6-4b6c-a0af-3c1ed0f407f9"
20        }
21      },
22      "region": {
23        "links": {
24          "self": "https://api.didww.com/v3/cities/498f2880-591f-436d-aacd-46ad3a7d8be8/relationships/region",
25          "related": "https://api.didww.com/v3/cities/498f2880-591f-436d-aacd-46ad3a7d8be8/region"
26        }
27      },
28      "area": {
29        "links": {
30          "self": "https://api.didww.com/v3/cities/498f2880-591f-436d-aacd-46ad3a7d8be8/relationships/area",
31          "related": "https://api.didww.com/v3/cities/498f2880-591f-436d-aacd-46ad3a7d8be8/area"
32        }
33      }
34    }
35  },
36  "included": [
37    {
38      "id": "2e89d524-55b6-4b6c-a0af-3c1ed0f407f9",
39      "type": "countries",
40      "attributes": {
41        "name": "United Kingdom",
42        "prefix": "44",
43        "iso": "GB"
44      },
45      "relationships": {
46        "regions": {
47          "links": {
48            "self": "https://api.didww.com/v3/countries/2e89d524-55b6-4b6c-a0af-3c1ed0f407f9/relationships/regions",
49            "related": "https://api.didww.com/v3/countries/2e89d524-55b6-4b6c-a0af-3c1ed0f407f9/regions"
50          }
51        }
52      }
53    }
54  ],
55  "meta": {
56    "api_version": "2026-11-19"
57  }
58}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 404 | No | [Not Found](../../../specification/errors/index.html#api-not-found) |
| 401 | No | [Unauthorized](../../authentication.html#authentication-v35) |
| 429 | No | The request budget of the account for the current window is spent (`too_many_requests`). `Retry-After` gives the number of seconds to wait. |
