Create a batch verification request.
curl --request POST \
--url https://api.bounceless.io/v1/requests \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"emails": [
"jsmith@example.com"
]
}
'{
"request": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mode": "<string>",
"state": "<string>",
"createdAt": "2023-11-07T05:31:56Z"
},
"counters": {},
"requestId": "<string>",
"replayed": true
}{
"request": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mode": "<string>",
"state": "<string>",
"createdAt": "2023-11-07T05:31:56Z"
},
"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>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"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
Create a batch
Submit a batch verification request.
POST
/
v1
/
requests
Create a batch verification request.
curl --request POST \
--url https://api.bounceless.io/v1/requests \
--header 'Content-Type: application/json' \
--header 'Idempotency-Key: <idempotency-key>' \
--header 'X-Api-Key: <api-key>' \
--data '
{
"emails": [
"jsmith@example.com"
]
}
'{
"request": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mode": "<string>",
"state": "<string>",
"createdAt": "2023-11-07T05:31:56Z"
},
"counters": {},
"requestId": "<string>",
"replayed": true
}{
"request": {
"id": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
"mode": "<string>",
"state": "<string>",
"createdAt": "2023-11-07T05:31:56Z"
},
"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>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>"
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"requestId": "<string>"
}
}Use a stable
Idempotency-Key for an identical submission. Creation returns 202; a replay returns 200 with the same request ID.Authorizations
Bounceless key in blc.… format.
Headers
Minimum string length:
1Body
application/json
Required array length:
1 - 10000 elementsMaximum string length:
320