Skip to content

Shipping policy

published · September 17, 2026

A shipping policy is the set of rules an account attaches to its address lookups — which signals block, a score ceiling, whether a register must confirm the building — deciding ok_to_ship.

A shipping policy is the set of three optional rules an account attaches to every address lookup it runs — the signals that block whenever they fire, a ceiling on the risk score, and whether a national register has to have confirmed the building — from which Spaw answers ok_to_ship on each response, with blocked_by naming the rule that decided. It turns a 61-field answer into the one boolean a checkout branches on.

What Spaw answers

An address that cannot stand as written is blocked first and always, with blocked_by: invalid. Otherwise the rules are applied in a fixed order: the first blocked signal in the published weights' order, then the score ceiling (blocked_by: risk_score), then the register requirement (blocked_by: unconfirmed, when exists is anything but true). Until an account sets a policy the defaults apply — undeliverable, placeholder and vacant block, so does any score over 60, and no register is required — and the policy endpoints or the Shipping policy tab change them for every member of the account, on the single and batch endpoints, bulk runs, monitors and the dashboard alike. An address on the account's suppression list answers blocked_by: suppressed.

What it does not mean

The policy is not the score. The seventeen weights stay published and recomputable, and reading the flags is still the right thing to do when a checkout needs more than one decision; the policy exists so that the common case needs one field. It is also the account's decision, not Spaw's: a mail drop scores 50 and passes the default ceiling, because whether a parcel may go to a mailbox shop is a merchant's call.

Related

markdown version: /glossary/shipping-policy.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.