batch_id.msisdns is the list of numbers, each with its country code and digits only.query_type is liveStatus for HLR lookups or npq for MNP lookups. Without it you get liveStatus.reference and webhook_url are optional and apply to the whole batch.GET /v1/async/batches/{batch_id}: it counts the tasks that are pending, running, finished and failed, and lists each task with its result. With webhook_url, finished tasks are posted to that address.estimated_total_cost is what the whole batch is expected to cost. Check your balance before a large batch.X-API-Key: YOUR_API_KEY.Authorization: Bearer YOUR_ACCESS_TOKEN. Obtain the token from POST /v1/auth/token.curl --location 'https://verify.veloconnect.me/v1/async/batch' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"msisdns": [
"447700900000",
"12025550123"
],
"query_type": "liveStatus",
"reference": "upload-2026-10-08",
"webhook_url": "https://example.com/webhooks/veloverify"
}'{
"batch_id": "22222222-2222-4222-8222-222222222222",
"total_tasks": 1,
"estimated_total_cost": 0.004,
"tasks": [
{
"task_id": "11111111-1111-4111-8111-111111111111",
"msisdn": "447700900000",
"status": "pending"
}
]
}