GET
/
v1.1
/
email
/
verify
/
batch
/
{batchId}
curl --request GET \
  --url https://api.usebouncer.com/v1.1/email/verify/batch/{batchId} \
  --header 'x-api-key: <api-key>'
{
  "batchId": "4d5fdf6b5ee97c4dbbccbfe1",
  "created": "2023-03-26T15:27:26.713Z",
  "started": "2023-03-26T15:27:30.124Z",
  "status": "processing",
  "quantity": 2,
  "duplicates": 0
}

Field “credits” will be filled with number of credits used once batch is complete.

Additional query parameter “with-stats=true” will add to the response processing progress and statistics.


{
    "batchId": "642152127eec9c46c00fb8d7",
    "created": "2023-03-27T08:21:38.357Z",
    "started": "2023-03-27T08:21:40.355Z",
    "completed": "2023-03-27T08:21:51.426Z",
    "status": "completed",
    "quantity": 2,
    "duplicates": 0,
    "credits": 2,
    "processed": 2,
    "stats": {
        "deliverable": 1,
        "risky": 0,
        "undeliverable": 1,
        "unknown": 0
    }
}

Authorizations

x-api-key
string
headerrequired

Path Parameters

batchId
string
required

batchId from create response

Query Parameters

with-stats
boolean

collect additional processing statistics

Response

200 - application/json

The response is of type object.

Create batch requestDelete request