Spaw
Get your API key

ADDRESS_LIST_UNAVAILABLE

No licensed partner lists addresses for that country

GET /api/v1/address/postcode/{postcode} needs an address-list partner, and none is configured for the country asked about. Nothing is charged.

http status
501
credits
Nothing is billed for a failed request.

What it means

Listing the addresses at a postcode is the one address answer no open dataset carries: every full list is derived from a postal operator's own address file, and serving it needs a licence. Spaw says so plainly rather than answering an empty list, which would read as "there are no addresses at this postcode".

The rest of the address API does not depend on it. Validating an address, its postcode, its type and its risk signals all work from the datasets Spaw ships and syncs, and are unaffected by this code.

What to do

Use POST /api/v1/address to validate an address you already hold. If you need postcode-to-address lookup, write to [email protected] with the countries you need it for.

Example response 

{
    "success": false,
    "error": {
        "code": "ADDRESS_LIST_UNAVAILABLE",
        "message": "Listing the addresses at a postcode needs a licensed address-list partner, and none is configured for GB.",
        "request_id": "req_01m1kgdm4xngzmbmff68g94w0c"
    }
}

Every error carries the request_id also sent in the X-Request-Id header; quote it when writing to support.

Related

markdown version: /docs/errors/ADDRESS_LIST_UNAVAILABLE.md