Fetch the check-address result (charged once on success)
V2 Public API
GET /v2/check-address/{check_id}/result
Fetch the verdict for a submitted check. Charged once, on first successful delivery.
GET
Fetch the check-address result (charged once on success)
Auth: Required · Billing: the check’s price, charged once here —
not on submit · Use case: collect the verdict from
POST /v2/check-addresscheck_id and a
result_url, and this endpoint is where the verdict arrives.
Request
Poll every few seconds. Typical completion is 5-90 s; a cold BFS on a
high-degree address can take longer.
Response 200 — the verdict
verdict.tier3_applied / tier4_applied show which depth tiers ran —
tier4_applied: false usually means too few transactions for a meaningful
BFS, and Tier 0+1+2 still executed.
For what decision means and how to act on it, see
POST /v2/check-address.
Other responses
Billing — charged once, on delivery
The submit call never charges. This endpoint charges on the first 200 it returns for a givencheck_id, and never again:
- Poll ten times before completion → ten
202s, no charge. - Poll again after the first
200→ same body, still one charge. - Check fails (
502) → no charge at all.
Idempotency-Key belongs on the submit, to avoid starting
a duplicate job.)
See also
- POST /v2/check-address — submit
- GET /v2/balance — what is left to spend
- GET /v2/me/usage — billing snapshot + history

