Validate Country Zipcode

GET /countries/{countryCode}/zipcodes/{zipcode}

Validate ZIP Code for country. This uses a regex to ensure the format is correct, and also does a lookup in the ZIP Code database if it matches an existing ZIP Code.

Path parameters

  • countryCode string Required

    ISO-3166 Alpha2 or Alpha3 code for country

  • zipcode string Required

    ZIP Code to validate

Responses

  • 200 application/json

    Validation result

    Hide response attributes Show response attributes object
  • 404

    Country not found

  • 422

    No or empty country/query specified

  • 403

    API key is missing or invalid

  • 429

    [FREE PLANS ONLY] Request Quota Exceeded

GET /countries/{countryCode}/zipcodes/{zipcode}
curl \
 -X GET https://api.tellusdb.com/v1/countries/US/zipcodes/90210?token=api_token_value
Response examples (200)
{
  "result": {
    "is_valid": true,
    "city": "Beverly Hills",
    "state": "CA"
  },
  "time_taken_ms": 1.3892211
}