# Get Countries

Returns a list of countries. [Pagination](../../../specification/pagination.html#api-pagination) is disabled.

## Request

HTTP Method: `GET`

URI Path: `/v3/countries`

Note

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

### URI Query Parameters

| Name | Type | Is Required? | Description |
| --- | --- | --- | --- |
| include | `string` | No | [Inclusion](../../../specification/includes.html#api-includes) |
| filter[<filter\_name>] | `string`, `boolean` | No | [Filtering](../../../specification/filtering.html#api-filters) |
| fields[countries] | `string` | No | [Sparse fieldsets](../../../specification/sparse-fieldsets.html#api-sparse-fieldsets) |
| sort | `string` | No | [Sorting](../../../specification/sorting.html#api-sorting) |

### Includes

| Value | Description |
| --- | --- |
| regions | [Region Object](../regions/region-object.html#region-object-v35) |

### Filters

| Filter Name | Type | Allow Blank | Allow Array | Filters by: |
| --- | --- | --- | --- | --- |
| id | `string` | No | Yes | Country `id` field. |
| name | `string` | Yes | Yes | Country `name` field. |
| prefix | `string` | Yes | Yes | Country `prefix` field. |
| iso | `string` | Yes | Yes | Country `iso` field. |
| is\_available | `boolean` | No | No | Indicates if DID numbers in the specified country are currently available for purchase. |

### Sorting

| Value | Sorts by |
| --- | --- |
| name | Country `name` field |
| prefix | Country `prefix` field |
| iso | Country `iso` field |

## Example

[[DIDWW-API-EXAMPLE-START]]

http

```
1GET /v3/countries 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/countries -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        {
 7            "id": "9c56fe0f-eff0-4742-85f6-24868959344a",
 8            "type": "countries",
 9            "attributes": {
10                "name": "United Kingdom",
11                "prefix": "44",
12                "iso": "GB"
13            },
14            "relationships": {
15                "regions": {
16                    "links": {
17                        "self": "https://api.didww.com/v3/countries/9c56fe0f-eff0-4742-85f6-24868959344a/relationships/regions",
18                        "related": "https://api.didww.com/v3/countries/9c56fe0f-eff0-4742-85f6-24868959344a/regions"
19                    }
20                }
21            }
22        },
23        {
24            "id": "5d3d7640-16d2-4dc0-9aca-408789fbefc6",
25            "type": "countries",
26            "attributes": {
27                "name": "United States",
28                "prefix": "1",
29                "iso": "US"
30            },
31            "relationships": {
32                "regions": {
33                    "links": {
34                        "self": "https://api.didww.com/v3/countries/5d3d7640-16d2-4dc0-9aca-408789fbefc6/relationships/regions",
35                        "related": "https://api.didww.com/v3/countries/5d3d7640-16d2-4dc0-9aca-408789fbefc6/regions"
36                    }
37                }
38            }
39        }
40    ],
41    "meta": {
42        "api_version": "2026-11-19"
43    }
44}
```

[[DIDWW-API-EXAMPLE-END]]

## Other Responses

| Code | Success | Description |
| --- | --- | --- |
| 400 | No | [Bad Request](../../../specification/errors/index.html#api-bad-request) |
| 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. |
