Get a batch verification request.
curl --request GET \
--url https://api.bounceless.io/v1/requests/{id} \
--header 'X-Api-Key: <api-key>'{
"request": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mode": "<string>",
"state": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"partial": true,
"finalized": true,
"countsMayChange": true,
"errorCode": "<string>",
"retentionExpiresAt": "2023-11-07T05:31:56Z",
"finalization": {}
},
"counters": {},
"requestId": "<string>",
"replayed": true
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>"
}
}API reference
Get batch status
Poll a batch verification request.
GET
/
v1
/
requests
/
{id}
Get a batch verification request.
curl --request GET \
--url https://api.bounceless.io/v1/requests/{id} \
--header 'X-Api-Key: <api-key>'{
"request": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mode": "<string>",
"state": "<string>",
"createdAt": "2023-11-07T05:31:56Z",
"partial": true,
"finalized": true,
"countsMayChange": true,
"errorCode": "<string>",
"retentionExpiresAt": "2023-11-07T05:31:56Z",
"finalization": {}
},
"counters": {},
"requestId": "<string>",
"replayed": true
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>"
}
}The request is visible only to the account identified by the pasted
X-Api-Key.
Do not treat a partial request as a complete export. Wait for request.finalized: true, then retrieve every results page.
Use the returned counters for progress reporting. Keep polling frequency bounded, surface an operational timeout to the caller, and retain the correlation ID when a job stops advancing. A terminal response describes the batch as a whole; individual decisions remain on the results endpoint.Authorizations
apiKeybearerAuth
Canonical authentication. Send a Bounceless key in blc.… format.