Get City

Description

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/

URI Query Parameters:

Name	Type	Is Required?	Description
id	string	Yes	Unique ID number for the city
include	string	Optional	Inclusion

Includes:

Value	Description
country	Country Object
region	Region Object

Examples

Simple RequestInclude Country

http

GET /v3/cities/cdf449bc-e3fb-42cc-bf31-b88f91e40de4 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 -X GET https://api.didww.com/v3/cities/cdf449bc-e3fb-42cc-bf31-b88f91e40de4 -H "Accept: application/vnd.api+json" -H "Api-Key: [API Token]" -H "Content-Type: application/vnd.api+json"

response

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

{
    "data": {
        "id": "cdf449bc-e3fb-42cc-bf31-b88f91e40de4",
        "type": "cities",
        "attributes": {
            "name": "London"
        },
        "relationships": {
            "country": {
                "links": {
                    "self": "https://api.didww.com/v3/cities/cdf449bc-e3fb-42cc-bf31-b88f91e40de4/relationships/country",
                    "related": "https://api.didww.com/v3/cities/cdf449bc-e3fb-42cc-bf31-b88f91e40de4/country"
                }
            },
            "region": {
                "links": {
                    "self": "https://api.didww.com/v3/cities/cdf449bc-e3fb-42cc-bf31-b88f91e40de4/relationships/region",
                    "related": "https://api.didww.com/v3/cities/cdf449bc-e3fb-42cc-bf31-b88f91e40de4/country"
                }
            }
        }
    },
    "meta": {
        "api_version": "2017-09-18"
    }
}

Other Responses

Code	Success	Description
404	No	Not Found
401	No	Unauthorized