Skip to content

ADDRESS_STREETS_NOT_FOUND

No street listing answers for that country or postcode

GET /api/v1/address/streets found nothing to report: no address register Spaw syncs carries a street listing for the country, the registers list no street at that postcode, or the listing does not cover it. Nothing is charged.

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

What it means

The street listing is read from the national address registers Spaw syncs — every street each one lists inside each postcode, in the register's own spelling. A country with no such register, or one whose register was synced before its listing existed, has no streets to answer with and answers this code.

A covered country answers it in three cases, and the message says which. "No street is listed at 9999 in CH." means the registers' coverage is complete and none of them holds an address at the postcode. Where a register whose coverage is complete holds addresses there but none on a named street, as in many Czech villages, the message says so. And a postcode the listing does not cover says that instead of reading as one with no street: 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), or a postcode the installed register cannot vouch for (a British district Open Names files no street under).

Validating a single address is unaffected; it works from the same registers and answers a verdict rather than this code.

What to do

Check the country is one whose address register Spaw carries with a street listing, and that the postcode is a real one in that country's own notation. A postcode the message says the listing does not cover answers the same way however it is written, so ask the customer for the street instead.

Example response

{
    "success": false,
    "error": {
        "code": "ADDRESS_STREETS_NOT_FOUND",
        "message": "No street is listed at 9999 in CH.",
        "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_STREETS_NOT_FOUND.md