Check up to 50 addresses for delivery in one call
POST/v2/bulk/address/validate
Runs the same check as POST /v2/address/validate on up to 50
addresses at once, for cleaning a customer list or an order import.
Results come back in input order, each with its row number and the
id you sent, so you can match them to your records.
A row with no usable input gets an error instead of a result; the
rest of the batch still runs. The summary counts rows by
possible_next_action.
For more than 50 addresses, submit a job with POST /v2/jobs and
type: address_validate.
Each call counts as one bulk request toward your plan's daily bulk
allowance. Pass an Idempotency-Key header to get the stored response
back if you retry.
Request
Responses
- 200
- 400
- 429
One result per item, in input order, and a summary
Invalid body, unknown field, no items, or more than 50 (INVALID_BODY, EMPTY_LIST, TOO_MANY)
Daily bulk allowance used up (BULK_LIMIT_EXCEEDED)