Skip to content
Spaw
Get your API key

Street suggestion

published · September 16, 2026

A street suggestion is the street a national register most likely meant when the one written on an address is not in the postcode but a close spelling is.

A street suggestion is the street a national register most likely meant when the one written on an address is not listed in its postcode but a close spelling is: Banhofstrasse against Bahnhofstrasse, Limatquai against Limmatquai.

What Spaw answers

street_suggestion carries the register's own spelling of the closest street, and null when the written street was found, when nothing in the postcode is close enough, or when no street listing is installed for the register. It is answered only when the address could be followed no further than its postcode — a register that found the street has nothing to suggest — and the comparison runs over the streets of that one postcode, never across a country. The same listing answers GET /api/v1/address/streets, which lists every street a register holds under a postcode.

What it is not

It is not a correction the answer applied. The address is measured as written, street echoes what was sent, and the suggestion is a separate field for the caller to accept or ignore; the confirmation map still reads unconfirmed for the street until it is.

Related

markdown version: /glossary/street-suggestion.md

Verify addresses the same way

The Spaw API runs every check described here on each lookup, with an SMTP handshake that never sends mail. 10 free lookups a month, no card required.

Get your API key

More glossary

  • Area-code overlay

    An area-code overlay is a new area code added over the same area as an existing one, instead of splitting it, so neighbours can hold different codes and local calls need ten digits.

  • Calling window

    A calling window is the span of local hours a sender contacts people in. Spaw answers in_call_window from the number's time zones: clock arithmetic, not compliance advice.

  • Fictional number

    A fictional number sits in a range kept out of service for films, TV and other fiction: 555-0100 to 555-0199 in North America, and ranges Ofcom, ARCEP, ACMA and ComReg reserve elsewhere.

  • International (exit) prefix

    An international prefix is what is dialled to leave a country before the calling code: 00 in most of the world, 011 in North America. Spaw reads it and suggests a fix in did_you_mean.

  • International network number

    An international network number sits under a calling code the ITU gives a global service rather than a country, such as +870, +881, +882 or +883, so its country is null.

  • Live carrier check (HLR lookup)

    A live carrier check asks the mobile networks, at the moment of the lookup, whether a number is in service, which network serves it and whether it is roaming. On Spaw it is not enabled.

  • Number pooling (thousands-blocks)

    Number pooling splits a North American central office code into ten blocks of a thousand numbers, each assigned to a carrier separately, so one code can hold several carriers' numbers.

  • Number portability

    Number portability lets a subscriber keep a phone number when changing carrier. The number's block stays listed under the carrier it was issued to, so block data names the original holder.