Get Country

Description:

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/

URI Query Parameters:

Name

Type

Is Required?

Description

id

string

Yes

Unique ID number for the country

Example

http

GET /v3/countries/e352699c-3764-415b-8946-dd470c1e0ed7 HTTP/1.1
Host: api.didww.com
Content-Type: application/vnd.api+json
Accept: application/vnd.api+json
Api-Key: [API Token]

curl

curl -i https://api.didww.com/v3/countries/e352699c-3764-415b-8946-dd470c1e0ed7 -H 'Accept: application/vnd.api+json' -H 'Api-Key: [API Token]' -H 'Content-Type: application/vnd.api+json'

response

HTTP/2 200 OK
Content-Type: application/vnd.api+json

{
   "data": {
      "id": "e352699c-3764-415b-8946-dd470c1e0ed7",
      "type": "countries",
      "attributes": {
            "name": "United Kingdom",
            "prefix": "44",
            "iso": "GB"
      },
      "relationships": {
            "regions": {
               "links": {
                  "self": "https://api.didww.com/v3/countries/e352699c-3764-415b-8946-dd470c1e0ed7/relationships/regions",
                  "related": "https://api.didww.com/v3/countries/e352699c-3764-415b-8946-dd470c1e0ed7/regions"
               }
            }
      }
   },
   "meta": {
      "api_version": "2017-09-18"
   }
}

Other Responses

Code

Success

Description

404

No

Not Found

401

No

Unauthorized