1. Geo
Cold Mail Reseller
  • Cold Mail Reseller API Documentation
  • Users
    • Retrieve all users
      GET
    • Get User Details
      GET
    • Create User
      POST
    • Update User Details
      PUT
    • Delete User
      DELETE
  • Geo
    • Get Countries List
      GET
    • Get States of a Country
      GET
  • Domains
    • Renewal
      • Domain Renewal Overview
      • Get domain renewal pricing
      • Renew domain
      • Enable or disable domain auto-renew
    • Get Domains For User
      GET
    • Suggest Available Domains
      POST
    • Get Single Available Domain
      POST
    • Check If Google Workspace Exists
      POST
    • Add domain forwarding
      POST
    • Add email forwarding
      POST
    • Add Google Client ID to Domain
      POST
    • Remove domains
      DELETE
  • Dns
    • Get dns records for a domain
      GET
    • Adds dns record
      POST
    • Update dns records
      PUT
    • Delete dns records
      DELETE
  • Orders
    • Get Order Details
      GET
    • Get Order Status
      GET
    • Creates order json
      POST
    • Order mailboxes (json)
      POST
    • Process the Order
      POST
    • Create Order
      POST
    • Add mailboxes to a subscription
      POST
  • Mailboxes
    • Get mailboxes for user
    • Get mailbox details by id
    • Get Mailbox Admin Details
    • Update mailbox details
    • Remove mailbox
  • Subscriptions
    • Get All Subscriptions
    • Renew Subscriptions
    • Toggle Auto renewal
    • Cancel Subscription
  • Webhooks
    • Overview
    • Events
      • Domain Events
      • Subscription Events
      • Mailbox Events
      • Prewarmup Events
  • Export
    • Re-export a mailbox (Oauth)
  • Pre-warmup
    • Get all pre warmed up mailboxes
    • Order pre-warmedup mailboxes
  • Get Wallet Details
    GET
  • Send error
    POST
  1. Geo

Get States of a Country

GET
/geo/states
Retrieves a list of states or provinces for a specified country. Used for completing address information during domain registration.

Query Parameters#

NameTypeRequiredDescriptionExample
countryCodestringYesISO country codeIN

Request

Authorization
API Key
Add parameter in header
cmr-x-api-key
Example:
cmr-x-api-key: ********************
or
Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://customers.coldmailreseller.com/api/v1/integration/geo/states' \
--header 'cmr-x-api-key: <api-key>'

Responses

🟢200Success
application/json
Body

Example
{
    "status": 200,
    "message": "States of country",
    "data": {
        "states": {
            "Andaman and Nicobar Islands": "1711",
            "Andhra Pradesh": "1712",
            "Arunachal Pradesh": "1713",
            "Assam": "1714",
            "Bihar": "1715",
            "Chandigarh": "1716",
            "Chhattisgarh": "3868",
            "Dadra and Nagar Haveli and Daman and Diu": "1717",
            "Delhi": "1719",
            "Goa": "1720",
            "Gujarat": "1721",
            "Haryana": "1722",
            "Himachal Pradesh": "1723",
            "Jammu and Kashmir": "1724",
            "Jharkhand": "3951",
            "Karnataka": "1725",
            "Kerala": "1726",
            "Ladakh": "4317",
            "Lakshadweep": "1727",
            "Madhya Pradesh": "1728",
            "Maharashtra": "1729",
            "Manipur": "1730",
            "Meghalaya": "1731",
            "Mizoram": "1732",
            "Nagaland": "1733",
            "Orissa": "1734",
            "Pondicherry": "1735",
            "Punjab": "1736",
            "Rajasthan": "1737",
            "Sikkim": "1738",
            "Tamil Nadu": "1739",
            "Telangana": "4284",
            "Tripura": "1740",
            "Uttar Pradesh": "1741",
            "Uttarakhand": "3867",
            "West Bengal": "1742"
        }
    }
}
🟠422Unprocessable Entity
Modified at 2025-10-29 17:04:58
Previous
Get Countries List
Next
Domain Renewal Overview
Built with