City Codes

GET

/api/v1/reference/cities

Valid city codes for the town field of Create User. Query param country is a 2-letter ISO code (default TR). Cached server-side for 24h.

Request

Query Params

Header Params

Responses

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.paylandcard.com/api/v1/reference/cities?country=TR' \
--header 'X-Api-Key: {{api_key}}' \
--header 'X-Timestamp: {{timestamp}}' \
--header 'X-Signature: {{signature}}' \
--header 'Accept: application/json'

Response Example

{
    "data": {
        "country": "TR",
        "cities": [
            {
                "code": "TR-34-01",
                "name": "Istanbul"
            },
            {
                "code": "TR-06-01",
                "name": "Ankara"
            },
            {
                "code": "TR-35-01",
                "name": "Izmir"
            }
        ],
        "source": "provider"
    },
    "status": true
}

Modified at 2026-07-17 06:22:49

Get User

Create Card