This document is generated by Aladia.

Aladia API

List All States

Developing

GET

/global/states

This endpoint lists all states.

Request Example

Shell

JavaScript

Java

Swift

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

Response Example

200 - Success

{
    "data": [
        {
            "id": "66dacd0d773e6e2d12a51374",
            "name": "suscipit ducimus officiis",
            "countryName": "repudiandae odio sequi",
            "stateCode": "ut cillum"
        },
        {
            "id": "66dacd0d773e6e2d12a51375",
            "name": "molestias saepe quis",
            "countryName": "mollitia quaerat fugiat",
            "stateCode": "qui"
        }
    ],
    "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 (state.model) {6}]

required

string

required

id of the state

name

string

optional

name of the state

countryName

string

optional

country where the state belongs

stateCode

string

optional

the code of the state

latitude

string

optional

Latitiude of the state

longitude

string

optional

Longitude of the state

cursor

object (cursor)

required

string | null

required

string | null

required

totalItems

integer

required

🟠422Parameter Error

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

Search Job Roles

Search States