Skip to content

Credit

published · September 10, 2026

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.

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. There is one balance and it does not care which endpoint spends it.

What does not cost one

Three things, and they are the reason the rate card exists rather than a single sentence.

A non-answer is free. What counts as one differs by signal and is published per signal on the pricing page: an undeliverable email address, an invalid phone number, an unparseable postal address, an identifier no installed register carries. A rejected request is free — a validation error, a refused key, a rate limit. And a repeat of the same value inside seven days is free, held as a keyed marker that stores a hash rather than the value.

An answer lost to an outage in the partner infrastructure behind the mailbox handshake is also free, because nothing was established.

When there are none left

The API answers 402 INSUFFICIENT_CREDITS before running the lookup, so an empty balance never bills for work that could not complete. Free credits renew at the start of each month; bought credits never expire.

meta.credits_used on every response says what that call actually cost, including zero.

Related

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

  • Address register

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

  • 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.

  • 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.