CAcallr
Phone Numbers Store

Buy phone numbers

Changed on

Buy phone numbers previously reserved, with the token returned by the /numbers/store endpoint.

This is a purchase: the numbers are billed (setup fee and monthly fee, see the reservation pricing) and committed for the contract duration.

Some reserved numbers may fail to be bought: they are listed in errors, while items lists the numbers actually bought.

post/numbers/store/{token}

Request

  • Base URL
    https://api.callr.com/v2.0
  • URL
    https://api.callr.com/v2.0/numbers/store/{token}
  • Auth
    • API key in header x-api-key
    • or HTTP basic

Path parameters

tokenstring required

Reservation token

Response

Phone numbers bought

Example response

{
  "contract": {
    "paymentType": "prepaid",
    "ends": "2024-04-24T17:42:28Z"
  },
  "errors": [
    {
      "number": "+33199001234"
    }
  ],
  "items": [
    {
      "number": "+33199001234",
      "pricing": {
        "minute": "5.50",
        "mrc": "5.50",
        "nrc": "5.50",
        "setup": "5.50"
      }
    }
  ]
}

Changes