Submit a batch of lookups

POST

/v1/async/batch

Async Queries

Last modified:2026-10-08 12:57:45

Submit a batch of up to 1000 async queries.

Request

Authorization

Body Params application/jsonRequired

Examples

Responses

🟢202

application/json

Successful Response

Bodyapplication/json

🟠422

Request Example

Shell

JavaScript

Java

Swift

cURLHttpiewget

curl --location 'https://verify.veloconnect.me/v1/async/batch' \
--header 'Content-Type: application/json' \
--data '{
    "msisdns": [
        "447700900000",
        "12025550123"
    ],
    "query_type": "liveStatus",
    "reference": "upload-2026-10-08",
    "webhook_url": "https://example.com/webhooks/veloverify"
}'

Response Example

202 - Example 1

{
    "batch_id": "4da22c97-b7d5-4e31-8c3a-03870ebc7b20",
    "total_tasks": 0,
    "estimated_total_cost": 0,
    "tasks": [
        {
            "task_id": "736fde4d-9029-4915-8189-01353d6982cb",
            "msisdn": "string",
            "status": "pending"
        }
    ]
}

Modified at 2026-10-08 12:57:45

Submit an asynchronous MNP lookup

Get task status