Dialing Area Codes API - Global Zip ZIP

1. API Overview & Setup

We provide a free, high-performance, and publicly available Global Dialing Codes & Zip Lookup API. It is engineered to help programmers, developers, and QA engineers instantly fetch regional prefixes, country parameters, dialing conventions, and verified ZIP directories.
All API endpoints respond in standard application/json payloads and support Cross-Origin Resource Sharing (CORS) with robust CDN edge caching enabled.

2. Get Supported Countries List

Retrieve metadata for all countries supported in our system, including two-letter ISO country codes, English name, native translated name, flag emoji, and the corresponding subdomain folder.

            GET https://api.xmzxw.com/v1/countries
          

Response Sample:

[
  {
    "code": "CN",
    "name": "China",
    "englishName": "China",
    "flag": "🇨🇳",
    "folder": "cn-zip"
  },
  {
    "code": "US",
    "name": "United States",
    "englishName": "United States",
    "flag": "🇺🇸",
    "folder": "us-zip"
  }
]

3. Retrieve States & Provinces List

Fetch all states, provinces, or federal districts grouped under a specific country using its 2-letter country code.

            GET https://api.xmzxw.com/v1/states?country=US
          

Response Sample:

{
  "country_code": "US",
  "states": [
    { "slug": "california", "name": "California", "translatedName": "California" },
    { "slug": "new-york", "name": "New York", "translatedName": "New York" }
  ]
}

4. Query City and Dialing/ZIP Rules

Get comprehensive info for a city, including its registered postal codes, telephone subscriber length, area codes, and standard international prefix.

            GET https://api.xmzxw.com/v1/city?country=CN&state=guangdong&city=shenzhen
          

Response Sample:

{
  "city": "Shenzhen",
  "translatedName": "Shenzhen",
  "state": "Guangdong",
  "country": "CN",
  "phoneRules": {
    "countryPrefix": "+86",
    "areaCodes": ["0755"],
    "length": 8
  },
  "zips": [
    { "code": "518000", "district": "Futian District" },
    { "code": "518052", "district": "Nanshan District" }
  ]
}