Skip to content

Address register

published · September 10, 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. Six are installed here, and each publisher states how complete its own file is.

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 claims to list every address in its country and does not carry this one. In every other case it is null.

match_level says how far the address could be followed: premise, 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

Two of the six registers are partial by their publishers' own account: the American national database is contributed to voluntarily by states and local authorities, and the French one is still filling in. An address missing from a partial register may simply be in a part nobody has shared yet, 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

  • ASN

    An Autonomous System Number identifies one network that announces its own routes to the internet under a single routing policy.

  • CIDR

    CIDR notation writes a range of IP addresses as one address and a prefix length, so 203.0.113.0/24 means the 256 addresses sharing those first 24 bits.

  • Catch-all domain

    A catch-all domain is one whose mail server accepts mail addressed to every recipient, whether or not that mailbox exists.

  • Check digit

    A check digit is a digit computed from the rest of an identifier so that a mistyped one usually fails arithmetic before anybody looks it up.

  • Company number

    A company number is the identifier a national registrar assigns to an incorporated company, unique within that register and never within the world.

  • Credit

    A credit is the billing unit of the whole API: one credit buys one fresh lookup that produced a usable answer, on any of the six signals.

  • Datacenter IP

    A datacenter IP is an address inside a range operated by a hosting, cloud or server provider rather than by a consumer access network.

  • Delivery point

    A delivery point is the smallest unit a postal service delivers to: one letterbox, one door, one box at a counter.