Addresses · Source: GeoNames (CC BY 4.0) · Refreshed weekly

World States and Provinces: ISO 3166-2 List and API

First-level administrative divisions for every country, about 3,900 rows, for the state field on consignee and notify-party forms. Data from GeoNames under CC BY 4.0, refreshed weekly.

Request

curl "https://api.eximfetch.com/world-states?countryCode=IN&q=tamil" \
  -H "Authorization: Bearer $EXIMFETCH_API_KEY"

Response

Real records from the dataset. Every list endpoint returns the same envelope and supports page and limit.

{
  "success": true,
  "data": [
    {
      "countryCode": "IN",
      "stateCode": "25",
      "name": "Tamil Nadu",
      "asciiName": "Tamil Nadu",
      "geonameId": 1255053
    }
  ],
  "pagination": {
    "currentPage": 1,
    "totalPages": 1,
    "totalCount": 1,
    "limit": 25,
    "hasNextPage": false,
    "hasPrevPage": false
  }
}

More requests

  • States of a country

    ISO-3166 alpha-2 country code

    GET /world-states?countryCode=IN
  • Search by name

    Name prefix

    GET /world-states?countryCode=US&q=new