Buy a phone number

​

Orders one of the numbers returned by the search. The answer is 202 Accepted with the order in a pending state: the carrier completes the purchase in the background, usually within a minute. Poll the order until it reports success or failure. The number can be used as a caller ID only after Resia has confirmed with the carrier that it is live.

Body·

required
application/json
  • phone_number
    Type: string
    required

Responses

  • application/json
  • application/json
Request Example for post/v1/phone-number-orders
curl /v1/phone-number-orders \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "phone_number": ""
}'

{
  "phone_number_order_id": "string",
  "phone_number": "string",
  "status": "pending",
  "created_at": "2026-09-24T21:09:12.160Z",
  "updated_at": "2026-09-24T21:09:12.160Z"
}

Successful Response