This document is generated by Aladia.

Aladia API

List All Cities

Developing

GET

/global/cities

This endpoint lists all cities.

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.aladia.io/v2/global/cities?limit=50&next=&prev=&sortBy=&sortDirection=asc&query=' \
--header 'apikey: '

Response Example

200 - Success

{
  "data": [
    {
      "id": "66dacd0d773e6e2d12a51376",
      "name": "aperiam numquam nisi",
      "stateName": "maxime doloremque dignissimos",
      "countryName": "eos facere voluptatibus"
    },
    {
      "id": "66dacd0d773e6e2d12a5137f",
      "name": "consequuntur qui quae",
      "stateName": "voluptate ipsum neque",
      "countryName": "deleniti eveniet molestias"
    }
  ],
  "cursor": {
    "next": null,
    "prev": null,
    "totalItems": 2
  }
}

Request

Query Params

limit

integer

optional

Number of documents per page in the response

Default:

string

optional

Next token cursor, to navigate towards the next page

string

optional

Previous token cursor, to navigate towards the previous page

sortBy

string

optional

Optional field to be used as a sorting reference

sortDirection

enum<string>

optional

Set the results in ascending (asc) or descending (desc) direction

Allowed values:

ascdesc

Default:

asc

query

string

optional

The search query string.

Header Params

apikey

string

optional

Example:

Responses

🟢200Success

application/json

Body

data

array[object (city.model) {6}]

required

string

required

id of the state

name

string

optional

name of the state

stateName

string

optional

the state where the city belongs

countryName

string

optional

the country where the state belongs

latitude

string

optional

latitude of the city

longitude

string

required

longitude of the city

cursor

object (cursor)

required

string | null

required

string | null

required

totalItems

integer

required

🟠422Parameter Error

Modified at 2025-04-12 09:37:22

Search States

Search Cities