List States

GET

/geo/states

Returns states or provinces for a given country code.

Required for user registration in countries that have state-level address fields.

Request

Query Params

Responses

🟢200Success

application/json

States of country

Bodyapplication/json

🟠422Validation Error

🟠400Bad Request

🟠401Unauthorized

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://customers.coldmailreseller.com/api/v1/integration/geo/states?countryCode=US' \
--header 'cmr-x-api-key: <api-key>'

Response Example

200 - Example 1

{
    "status": 200,
    "message": "States of country",
    "data": {
        "states": {
            "California": "CA",
            "Texas": "TX"
        }
    }
}

Modified at 2026-08-06 07:14:12

List Countries

Get Domain Renewal Prices