Available numbers
Endpoint
GET /v1/verification-groups/{id}/available-phone-numbersPath Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
id | uuid | Yes | Verification group ID |
Query Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
query | string | No | - | Filter by phone number pattern |
limit | integer | No | 20 | Maximum results (1-50) |
Example Request
Example Response
{
"data": [
{
"phone_number": "+31201234567",
"locality": "Amsterdam",
"number_type": "local",
"features": ["voice", "sms"],
"cost": {
"monthly": "2.50",
"currency": "EUR",
"credits": 10
},
"reservable": true
},
{
"phone_number": "+31201234568",
"locality": "Amsterdam",
"number_type": "local",
"features": ["voice"],
"cost": {
"monthly": "2.50",
"currency": "EUR",
"credits": 10
},
"reservable": true
}
],
"meta": {
"verification_group": {
"id": "550e8400-e29b-41d4-a716-446655440000",
"status": "approved",
"phone_number_type": "local",
"locality": "Amsterdam"
},
"total_results": 2
}
}Response JSON Schema
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"phone_number": { "type": "string" },
"locality": { "type": "string", "nullable": true },
"number_type": { "type": "string" },
"features": {
"type": "array",
"items": { "type": "string" }
},
"cost": {
"type": "object",
"properties": {
"monthly": { "type": "string" },
"currency": { "type": "string" },
"credits": { "type": "integer" }
}
},
"reservable": { "type": "boolean" }
}
}
},
"meta": {
"type": "object",
"properties": {
"verification_group": {
"type": "object",
"properties": {
"id": { "type": "string", "format": "uuid" },
"status": { "type": "string" },
"phone_number_type": { "type": "string" },
"locality": { "type": "string", "nullable": true }
}
},
"total_results": { "type": "integer" }
}
}
}
}Error Codes
| Code | HTTP Status | Description |
|---|---|---|
not_found | 404 | Verification group not found |
invalid_status | 400 | Group is not approved yet |
Found a number you like? Order it.
Modified at 2025-12-08 10:37:11