Skip to main content

Get cities by country

GET https://delivery-api.paysera.com/rest/v1/cities

Retrieve a list of cities for a specific country.

Use this endpoint to populate city dropdowns or validate city names.

Authorization​

This endpoint requires MAC (Message Authentication Code) authentication.

Authorization Header Format:

Authorization: MAC id="YOUR_PROJECT_ID",ts="1234567890",nonce="xyz123",mac="GENERATED_MAC_HASH"

Example:

Authorization: MAC id="a9b8c7d6e5f4g3h2", ts="1234567890", nonce="xyz123abc456def", mac="dGhpcyBpcyBhIHJhbmRvbSBtYWMgaGFzaCB2YWx1ZQ==", ext="body_hash=cmFuZG9tQm9keUhhc2hWYWx1ZQ%3D%3D"

For more details, please refer to the Authentication section.

Parameters​

Query Parameters​

NameTypeRequiredDescription
country_codestring✓Country code (ISO 3166-1 alpha-2)

Example​

Request​

GET https://delivery-api.paysera.com/rest/v1/cities?country_code=LT
Authorization: MAC id="CLIENT_ID", ts="TIMESTAMP", nonce="RANDOM_STRING", mac="MAC_HASH"

Response​

{}

AUTHORIZATION: HTTP

REQUEST

Base URL
https://delivery-api.paysera.com
Query Parameters
country_codeREQUIRED
Country code (ISO 3166-1 alpha-2)

RESPONSE

List of cities
{}