# Get Area

Returns an area for a given area ID. Note that a unique identification number is allocated to each area.

## Request

HTTP Method: `GET`

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

Note

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

### URI Query Parameters

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

### Includes

| Value | Description |
| --- | --- |
| country | [Country Object](../../coverage-resources/countries/country-object.html#country-object-v35) |

## Examples

Simple RequestInclude Country

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/areas/9fcc7390-84a2-47f1-a900-0558cdcb6ce3 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/areas/9fcc7390-84a2-47f1-a900-0558cdcb6ce3 -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": "9fcc7390-84a2-47f1-a900-0558cdcb6ce3",
 7    "type": "areas",
 8    "attributes": {
 9      "name": "Tuscany"
10    },
11    "relationships": {
12      "country": {
13        "links": {
14          "self": "https://api.didww.com/v3/areas/9fcc7390-84a2-47f1-a900-0558cdcb6ce3/relationships/country",
15          "related": "https://api.didww.com/v3/areas/9fcc7390-84a2-47f1-a900-0558cdcb6ce3/country"
16        }
17      }
18    }
19  },
20  "meta": {
21    "api_version": "2026-11-19"
22  }
23}
```

[[DIDWW-API-EXAMPLE-END]]

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/areas/9fcc7390-84a2-47f1-a900-0558cdcb6ce3?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/areas/9fcc7390-84a2-47f1-a900-0558cdcb6ce3?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": "9fcc7390-84a2-47f1-a900-0558cdcb6ce3",
 7    "type": "areas",
 8    "attributes": {
 9      "name": "Tuscany"
10    },
11    "relationships": {
12      "country": {
13        "links": {
14          "self": "https://api.didww.com/v3/areas/9fcc7390-84a2-47f1-a900-0558cdcb6ce3/relationships/country",
15          "related": "https://api.didww.com/v3/areas/9fcc7390-84a2-47f1-a900-0558cdcb6ce3/country"
16        },
17        "data": {
18          "type": "countries",
19          "id": "51d3fe2a-6588-496b-870c-398e627de5c4"
20        }
21      }
22    }
23  },
24  "included": [
25    {
26      "id": "51d3fe2a-6588-496b-870c-398e627de5c4",
27      "type": "countries",
28      "attributes": {
29        "name": "Italy",
30        "prefix": "39",
31        "iso": "IT"
32      },
33      "relationships": {
34        "regions": {
35          "links": {
36            "self": "https://api.didww.com/v3/countries/51d3fe2a-6588-496b-870c-398e627de5c4/relationships/regions",
37            "related": "https://api.didww.com/v3/countries/51d3fe2a-6588-496b-870c-398e627de5c4/regions"
38          }
39        }
40      }
41    }
42  ],
43  "meta": {
44    "api_version": "2026-11-19"
45  }
46}
```

[[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. |
