Submit an asynchronous MNP lookup

POST

/v1/async/mnp

Async Queries

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

Submit an asynchronous MNP lookup.

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/mnp' \
--header 'Content-Type: application/json' \
--data '{
    "msisdn": "447700900000",
    "reference": "customer-12345",
    "webhook_url": "https://example.com/webhooks/veloverify"
}'

Response Example

202 - Success Example

{
    "task_id": "4e8abe41-1da0-4e16-9c6f-9b38477ec1ed",
    "batch_id": "f8a0dbf8-6561-4239-aaaa-32b9b70c5c81",
    "msisdn": "447700900000",
    "status": "pending",
    "estimated_cost": 0.004
}

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

Submit an asynchronous HLR lookup

Submit a batch of lookups