Lookup

Validate a postal code

Lightweight check used by checkout forms. Returns whether the code exists and how many settlements it covers — but not the settlements themselves.

get/api/v1/{country}/validate/{codigo}

Request

  • Base URL: https://postali.app
  • URL: https://postali.app/api/v1/{country}/validate/{codigo}
  • Auth: none required

Path parameters

country'mx' | 'co' | 'es' required
Example:mx

ISO 3166-1 alpha-2 country code in lowercase. The path /api/v1/cp/... (without country) defaults to mx for backwards compatibility.

codigostring required
Example:06700

Response

Validation result.

cpstring required
validboolean required
asentamientosinteger required

Number of settlements covered by this postal code.

Changes

No recorded changes to this operation across all 1 revision of this API.