Skip to content

Address register

published · September 10, 2026 · updated · October 14, 2026

An address register is a country's official file of every address its authorities recognise, usually keyed on buildings rather than letterboxes.

An address register is a country's official file of the addresses its authorities recognise, usually keyed on buildings rather than letterboxes. Spaw reads the openly published registers synced to its servers — the address verification guide lists each with its licence — and each publisher states how complete its own file is, except where Spaw marks a register partial because its copy cannot vouch for an address it lacks: the address data sources page says which and why.

What Spaw answers

exists is the answer, and the rule behind it is the strictest thing in the address product. It is true only on a premise match — the building itself was found. It is false only when the register that answered has complete coverage and does not carry this one. In every other case it is null.

match_level says how far the address could be followed: premise, range (the house number falls inside a published range of numbers on the street), street, postcode or none. register names the file that answered and register_coverage reports complete or partial. Always read exists against that last field.

Why null is the common answer

Several registers are partial. Two are partial by their publishers' own account: the American national database, to which states and local authorities contribute voluntarily, and the French one, which is still filling in. Spaw marks the others partial on its own grounds. Brazil's is the address list of the 2022 census, a snapshot rather than a maintained register. Each German register covers one Land, and Germany has no national address register. Great Britain's, Ordnance Survey's Open Names, files each road under one postcode district, though a long road runs through several; it lists streets and never buildings, so it can never answer for a building at all. Denmark's copy is no longer refreshed: Klimadatastyrelsen lists every Danish address, but the copy here was taken on 26 September 2026, before the interface it was read through closed on 1 October 2026, so an address created since may be missing from it. An address missing from a partial register may be in a part nobody has shared yet, outside the area the register covers, or newer than the copy, so absence there is not evidence and the field says null instead of false.

The not_in_register risk signal (+20) fires only where exists is false — that is, only where a complete register was asked and answered.

Related

markdown version: /glossary/address-register.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.