Skip to content

Request id

published · September 10, 2026

A request id is the identifier stamped on one API call, returned in the X-Request-Id header and repeated inside the response body.

A request id is the identifier stamped on one API call. It comes back in the X-Request-Id response header and is repeated inside the body — in meta.request_id on a success and in error.request_id on a failure — so the same string exists on both sides of the call.

What it is for

Quoting one to support turns "a call failed yesterday" into a row somebody can read. Every request an account makes is recorded with its id, the endpoint, the status, the typed error code, the credits it cost and how long it took; the account's own list is at /requests, and the support form offers the newest ids so nobody has to go and find one.

The header is exposed to browser JavaScript on purpose, because the documentation tells callers to read it and a browser cannot read a header that is not listed in the CORS policy.

What the record does not hold

Not the value the call was about. The route is stored as its template, never as its path, so a request log row says that a phone lookup happened and never which number. Rows are deleted after 30 days.

Related

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

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