Purchase a phone number

POST

/api/phone-numbers/purchase

Purchases a number from the telephony provider and assigns it to the authenticated tenant immediately.

Request

Authorization

API Key

Add parameter in header

X-API-Key

Example:

X-API-Key: ********************

Body Params application/jsonRequired

Examples

Responses

🟢201

application/json

Number purchased and recorded for the tenant.

Bodyapplication/json

🟠401

🔴500

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.snakk.ai/api/phone-numbers/purchase' \
--header 'X-API-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
    "phoneNumber": "+4712345678"
}'

Response Example

201 - Example 1

{
    "phone_number": {
        "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
        "tenant_id": "34f5c98e-f430-457b-a812-92637d0c6fd0",
        "phone_number": "+4712345678",
        "country_code": "47",
        "number_type": "local",
        "assigned_to_agent": false,
        "monthly_cost_nok": 30
    },
    "message": "Phone number purchased successfully",
    "monthly_cost": 30
}

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

Search numbers available to purchase

Assign a number to an agent