Get batch verification results.
curl --request GET \
--url https://api.bounceless.io/v1/requests/{id}/results \
--header 'X-Api-Key: <api-key>'{
"jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"results": [
{
"email": "<string>",
"checkedAt": "2023-11-07T05:31:56Z",
"state": "<string>",
"score": 123,
"subStatus": "<string>",
"reasonCodes": [
"<string>"
],
"decision": {},
"presend": {
"contract_version": 1,
"status": "completed",
"outcome": "actionable_verdict",
"decision": "send",
"verdict": "DELIVERABLE",
"provider_family": "<string>",
"confidence": 0.5,
"reasons": [
"<string>"
],
"evidence_class": "<string>",
"retry": {
"eligible_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z",
"affinity_required": true
},
"billing": {
"disposition": "debited",
"credits": 1
},
"history": {}
}
}
],
"limit": 123,
"offset": 123,
"nextCursor": "<string>",
"partial": true,
"finalized": true,
"countsMayChange": true,
"requestId": "<string>"
}{
"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 results
Retrieve a page of batch verification results.
GET
/
v1
/
requests
/
{id}
/
results
Get batch verification results.
curl --request GET \
--url https://api.bounceless.io/v1/requests/{id}/results \
--header 'X-Api-Key: <api-key>'{
"jobId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"results": [
{
"email": "<string>",
"checkedAt": "2023-11-07T05:31:56Z",
"state": "<string>",
"score": 123,
"subStatus": "<string>",
"reasonCodes": [
"<string>"
],
"decision": {},
"presend": {
"contract_version": 1,
"status": "completed",
"outcome": "actionable_verdict",
"decision": "send",
"verdict": "DELIVERABLE",
"provider_family": "<string>",
"confidence": 0.5,
"reasons": [
"<string>"
],
"evidence_class": "<string>",
"retry": {
"eligible_at": "2023-11-07T05:31:56Z",
"expires_at": "2023-11-07T05:31:56Z",
"affinity_required": true
},
"billing": {
"disposition": "debited",
"credits": 1
},
"history": {}
}
}
],
"limit": 123,
"offset": 123,
"nextCursor": "<string>",
"partial": true,
"finalized": true,
"countsMayChange": true,
"requestId": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>"
}
}Use
cursor and the returned nextCursor for new integrations. Treat cursors as opaque and continue until nextCursor is null after the request is finalized. offset remains available for compatibility.Authorizations
apiKeybearerAuth
Canonical authentication. Send a Bounceless key in blc.… format.
Path Parameters
Query Parameters
Required range:
1 <= x <= 200Opaque cursor returned as nextCursor by the preceding page. Canonical for new integrations.
Minimum string length:
1Compatibility pagination. New integrations should use cursor and nextCursor.
Required range:
x >= 0Response
Paginated results
Show child attributes
Show child attributes
Pass a non-null value back as cursor. Null marks the last current page; only a finalized request is a complete collection.
True only while the request can still change the result counters.