BObounceless

Get a single verification result.

Poll the verifyRequestId returned by a 202 POST /v1/verify (for example every 2s under a client deadline) until status is completed or failed. running keeps the hold held and bills nothing; the first terminal result settles the charge once, and later reads return the stored result unchanged. Unknown ids, ids of another account, and accounts without async results enabled return 404 not_found.

get/v1/verify/{id}

Request

  • Base URL
    https://api.bounceless.io
  • Auth
    API key in header X-Api-Key

Path parameters

idstring uuid required

Response

Current result.

status'running' | 'completed' | 'failed' required
resultCategory'deliverable' | 'catch_all' | 'unknown' | 'undeliverable' | 'risky' | 'recheck' | 'pending' | 'other'
verifyRequestIdstring uuid
createdAtstring date-time
decisionobject nullable
isRoleboolean nullable

Engine role label (BL-11811). Not a check, never gating; null when the engine did not emit it.

requestIdstring required

Changes

No recorded changes to this operation across all 1 revision of this API.