Bulk

Look up multiple postal codes in a single request

Accepts up to 100 codes and resolves them in a single SQLite query. Invalid or unknown codes are returned with valid: false rather than aborting the whole batch. Rate-limited per IP at the edge.

post/api/v1/{country}/bulk

Request

Base URL: https://postali.app
URL: https://postali.app/api/v1/{country}/bulk
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.

Request body

cpsstring[] required

Example request

{
  "cps": [
    "06700",
    "44100",
    "00000"
  ]
}

Response

Results in the same order as the input.

totalinteger required

Changes

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