Validate order address

Use this endpoint to validate a shipping address before placing an order. Use this when end users are entering shipping addresses in your platform UI - validating up front catches errors early and reduces fulfillment failures.

Required fields:

• country - country code, 2-3 uppercase letters (ISO 3166-1 alpha-2 or alpha-3)
• address - the address object to validate. Contains:
  • addressLine1 - street address (validated as required)
  • addressLine2 - apartment, suite, floor (optional)
  • city - city name (validated as required)
  • state - state or province code (2-3 uppercase letters)
  • zipcode - postal/ZIP code (alphanumeric, 3-10 characters)

Optional parameters:

• Request-Source header - source of the request (api_native, api_zapier, api_salesforce, api_ftp, api_make)

Please note:

• Successful validation returns one of two result values:
  • verified - the address is correct and deliverable
  • ambiguous - the address was found but with ambiguity (e.g. multiple matches). Consider surfacing the response message to the end user to confirm before proceeding.
• Returns 400 with a per-field errors array when address validation fails (e.g. invalid address format, missing required fields). Each entry includes the offending path, a human-readable message, and the errorCode.
• Returns 422 when the address is well-formed but cannot be found by the validation service.
• This endpoint does not place an order - it’s a pre-flight check. Always follow up with placing an order once validation succeeds.

Permissions

• Requires: orders:read:masked or orders:read:unmasked