Get Country#

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

Request#

HTTP Method: GET

URI Path: /v3/countries/{id}

Note

For all returned data attributes, see Country Object.

URI Query Parameters#

Name

Type

Is Required?

Description

id

string

Yes

Unique ID number for the country

include

string

No

Inclusion

Includes#

Value

Description

regions

Region Object

Example#

http

1GET /v3/countries/e352699c-3764-415b-8946-dd470c1e0ed7 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/e352699c-3764-415b-8946-dd470c1e0ed7 -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": "e352699c-3764-415b-8946-dd470c1e0ed7",
 7        "type": "countries",
 8        "attributes": {
 9            "name": "United Kingdom",
10            "prefix": "44",
11            "iso": "GB"
12        },
13        "relationships": {
14            "regions": {
15                "links": {
16                    "self": "https://api.didww.com/v3/countries/e352699c-3764-415b-8946-dd470c1e0ed7/relationships/regions",
17                    "related": "https://api.didww.com/v3/countries/e352699c-3764-415b-8946-dd470c1e0ed7/regions"
18                }
19            }
20        }
21    },
22    "meta": {
23        "api_version": "2026-11-19"
24    }
25}

Other Responses#

Code

Success

Description

404

No

Not Found

401

No

Unauthorized

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.