curl --request POST \
  --url https://api.kallabot.com/v1/numbers/purchase \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --header 'Idempotency-Key: <idempotency-key>' \
  --data '
{
  "e164": "<string>",
  "country_code": "<string>"
}
'

const options = {
  method: 'POST',
  headers: {
    'Idempotency-Key': '<idempotency-key>',
    Authorization: 'Bearer <token>',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({e164: '<string>', country_code: '<string>'})
};

fetch('https://api.kallabot.com/v1/numbers/purchase', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

import requests

url = "https://api.kallabot.com/v1/numbers/purchase"

payload = {
    "e164": "<string>",
    "country_code": "<string>"
}
headers = {
    "Idempotency-Key": "<idempotency-key>",
    "Authorization": "Bearer <token>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

{
  "id": "<string>",
  "e164": "<string>",
  "label": "<string>",
  "source": "kallabot",
  "origin": "<string>",
  "status": "<string>",
  "state": "live",
  "state_detail": "<string>",
  "capabilities": {
    "voice": true,
    "sms": true,
    "mms": true,
    "fax": true
  },
  "can_call_out": true,
  "settings": {
    "mode": "<string>",
    "ring_seconds": 123,
    "ring_e164": "<string>",
    "failover_e164": "<string>",
    "office_hours": {
      "schedule": {},
      "timezone": "<string>"
    }
  },
  "country_code": "<string>",
  "number_type": "<string>",
  "connection_name": "<string>",
  "failure": "<string>",
  "agent": {
    "id": "<string>",
    "name": "<string>",
    "image": "<string>"
  },
  "route_id": "<string>",
  "bundle": {
    "id": "<string>",
    "name": "<string>",
    "stage": "<string>"
  },
  "bought_at": "<string>"
}

{
  "id": "<string>",
  "e164": "<string>",
  "label": "<string>",
  "source": "kallabot",
  "origin": "<string>",
  "status": "<string>",
  "state": "live",
  "state_detail": "<string>",
  "capabilities": {
    "voice": true,
    "sms": true,
    "mms": true,
    "fax": true
  },
  "can_call_out": true,
  "settings": {
    "mode": "<string>",
    "ring_seconds": 123,
    "ring_e164": "<string>",
    "failover_e164": "<string>",
    "office_hours": {
      "schedule": {},
      "timezone": "<string>"
    }
  },
  "country_code": "<string>",
  "number_type": "<string>",
  "connection_name": "<string>",
  "failure": "<string>",
  "agent": {
    "id": "<string>",
    "name": "<string>",
    "image": "<string>"
  },
  "route_id": "<string>",
  "bundle": {
    "id": "<string>",
    "name": "<string>",
    "stage": "<string>"
  },
  "bought_at": "<string>"
}

{
  "type": "https://docs.kallabot.com/errors/unsupported_api_version",
  "title": "Kallabot-Version names a version this API doesn't have",
  "status": 400,
  "code": "unsupported_api_version",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/unauthenticated",
  "title": "Missing or invalid API key",
  "status": 401,
  "code": "unauthenticated",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/insufficient_scope",
  "title": "The key lacks a required scope",
  "status": 403,
  "code": "insufficient_scope",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/revision_conflict",
  "title": "Conflicts with the resource's current state",
  "status": 409,
  "code": "revision_conflict",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/invalid_request",
  "title": "One or more fields are not valid",
  "status": 422,
  "code": "invalid_request",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/sdk_version_unsupported",
  "title": "This SDK release is switched off: upgrade the SDK",
  "status": 426,
  "code": "sdk_version_unsupported",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/precondition_required",
  "title": "A required header is missing (Idempotency-Key or If-Match)",
  "status": 428,
  "code": "precondition_required",
  "retryable": false
}

{
  "type": "https://docs.kallabot.com/errors/rate_limited",
  "title": "Too many requests",
  "status": 429,
  "code": "rate_limited",
  "retryable": true
}

{
  "type": "https://docs.kallabot.com/errors/internal_error",
  "title": "Something went wrong on our side",
  "status": 500,
  "code": "internal_error",
  "retryable": true
}