curl -X GET 'https://api.countrystatecity.in/v1/phone/parse?number=%2B14155552671' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

curl -X GET 'https://api.countrystatecity.in/v1/phone/parse?number=%2B919876543210' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

curl -X GET 'https://api.countrystatecity.in/v1/phone/parse?number=%2B12465551234' \
  -H 'X-CSCAPI-KEY: YOUR_API_KEY'

const number = '+14155552671';
const response = await fetch(
  `https://api.countrystatecity.in/v1/phone/parse?number=${encodeURIComponent(number)}`,
  { headers: { 'X-CSCAPI-KEY': 'YOUR_API_KEY' } }
);

const parsed = await response.json();
// { country: "US", dial_code: "+1", iso2: "US", iso3: "USA",
//   national_number: "4155552671", e164: "+14155552671" }

import requests

response = requests.get(
  'https://api.countrystatecity.in/v1/phone/parse',
  params={'number': '+919876543210'},
  headers={'X-CSCAPI-KEY': 'YOUR_API_KEY'}
)

parsed = response.json()
print(f"{parsed['country']} | {parsed['dial_code']} | national {parsed['national_number']}")

{
  "country": "US",
  "dial_code": "+1",
  "iso2": "US",
  "iso3": "USA",
  "national_number": "4155552671",
  "e164": "+14155552671"
}

{
  "country": "BB",
  "dial_code": "+1",
  "area_code": "246",
  "iso2": "BB",
  "iso3": "BRB",
  "national_number": "2465551234",
  "e164": "+12465551234"
}

{
  "country": "IL",
  "dial_code": "+972",
  "iso2": "IL",
  "iso3": "ISR",
  "national_number": "501234567",
  "e164": "+972501234567"
}

{
  "status": "error",
  "message": "Missing required query parameter: number"
}

{
  "status": "error",
  "message": "Phone number must be in E.164 format starting with + (e.g., +14155552671)."
}

{
  "status": "error",
  "message": "Invalid phone number. Must contain 5-15 digits after the +."
}

{
  "status": "error",
  "message": "This feature is not available on your current plan.",
  "details": {
    "feature": "phoneDialCode",
    "currentTier": "community",
    "requiredTier": "starter",
    "upgradeUrl": "https://app.countrystatecity.in/pricing"
  }
}

{
  "status": "error",
  "message": "Could not identify a country for the given phone number."
}