v7

latestOpenAPI 3.0.0raw.githubusercontent.com2026-06-121372601.5 MB
International API

Verify a batch of international addresses in a single request. Each address can be freeform or structured, matching the same input formats accepted by the single verification endpoint.

  • Accepts up to 2,000 addresses per request.
  • Uses 1 lookup per address.
  • Requires a secret API key.
  • Returns results in the same order as the input addresses.
  • If an individual address fails, its result will contain an error field rather than a verifiedAddress.
  • If you are not subscribed and the batch would exceed your remaining free lookups, the entire batch fails (nothing is verified). Size your batch to the number of lookups you have left.
post/v1/intl_addver/verifications/batch

Query parameters

includeDetailsboolean
properCaseboolean
geoDataboolean
useEnhancedChinaDatasetboolean

Request body

Response

The request has succeeded.

status'success' | 'error' required
messagestring required