ADDRESS_LIST_UNAVAILABLE
No licensed list or open street listing covers that country or postcode
GET /api/v1/address/postcode/{postcode} answers from a licensed address-list partner or from an open register's street listing, and neither covers the country asked about, or the installed listing cannot speak for that postcode. Nothing is charged.
- http status
- 501
- credits
- A failure after the lookup ran leaves the credit spent; every other failure bills nothing.
What it means
Every full list of the delivery points at a postcode is derived from a postal operator's own address file, and serving it needs a licence. Where an open national register publishes its streets, the endpoint answers those streets at the postcode instead, with no house numbers; a country with neither answers this code. Spaw says so plainly rather than answering an empty list, which would read as "there are no addresses at this postcode".
For the same reason a covered country answers it for a postcode its listing cannot speak for, and the message says which case it is: a code outside the register's area (Northern Irish BT, forces BFPO and BF, and non-geographic BX codes are outside Ordnance Survey's Great Britain data), a postcode in a part of the country no installed register covers (Germany outside Berlin, whose other registers are filed by town, or a Belgian region whose register is not installed), a postcode the installed register cannot vouch for (a British district Open Names files no street under, since Ordnance Survey files each road under one district), and a postcode where a register whose coverage is complete holds addresses but none on a named street, as in many Czech villages. An empty list is answered only where the registers' coverage is complete and none of them holds an address at the postcode, and it is free too.
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 or an open register with a street listing, and neither is configured for IT.",
"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
- ASN_INDEX_UNAVAILABLE · the ASN prefix index has not been built on this server
- All error codes
- Verdicts and the risk score
- API reference
markdown version: /docs/errors/ADDRESS_LIST_UNAVAILABLE.md