Bulk-purchase phone numbers

POST

/api/admin/phone-numbers/bulk-purchase

Searches for available telephony numbers and purchases the requested quantity into the shared pool.

Request

Authorization

API Key

Add parameter in header

X-Admin-Key

Example:

X-Admin-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢200

application/json

Purchase result

Bodyapplication/json

🟠400

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/admin/phone-numbers/bulk-purchase' \
--header 'X-Admin-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "countryCode": "NO",
    "quantity": 1,
    "locality": "string"
}'

Response Example

{
    "success": true,
    "purchased": 0,
    "failed": 0,
    "phone_numbers": [
        {}
    ],
    "errors": [
        {
            "number": "string",
            "error": "string"
        }
    ]
}

Modified at 2026-07-08 19:01:40

Revenue breakdown by month

List all phone numbers (pool)