Skip to content
Spaw
Get your API key

Premise key

published · September 16, 2026

A premise key is the digest of one building — country, postcode or town, folded street name and house number — that every spelling of the same address shares.

A premise key is the digest of one building: the country, the postcode or the town where there is no postcode, the street name folded to its comparison form and the house number, hashed so that "12 High St", "12 High Street" and "12, HIGH STREET" all share one key.

What Spaw answers

premise_key carries that digest in hex on every valid answer that names a street and a house number, and null where there is no building to key — a box, a street without a number, an address with neither postcode nor town. It is the same key the national registers are compiled under, the key an account's own delivery reports are filed under, and the key the suppression list holds, so a customer can join lookups, feedback and suppressions on one value, or deduplicate a list without re-implementing the folding.

What it is a fact about

A place, and only a place: the key is derived from the address parts and nothing else, carries no name, and is the same for everyone who writes that address. It changes only when the folding rules change, which the address-rules version in sources records.

Related

markdown version: /glossary/premise-key.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.