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. With campaign_id, Resia puts the new number on that 10DLC campaign when the purchase completes, before the order reports success. If the carrier registry then refuses the number, for example because the campaign is not active, the order still succeeds and the number is on no campaign; check GET /v1/10dlc/campaigns/{campaign_id}/phone-numbers, and attach it with POST /v1/10dlc/campaigns/{campaign_id}/phone-numbers. A campaign without a number pool takes at most 49 numbers through an order.

Headers

  • For Resia staff only. Omit it: your key acts on your own organization.

Body·

required
application/json
  • A 10DLC campaign of your organization. When the purchase completes, Resia puts the new number on this campaign. Omit it to leave the number on no campaign.

Responses

  • application/json
  • insufficient_funds: your prepaid balance is $0.00 or less. Nothing was ordered. Add funds, then order again.

  • not_found: no campaign with that campaign_id exists for your organization. Nothing was ordered.

  • conflict: the carrier no longer has this number available; or the campaign_id campaign has no number pool and already holds 49 numbers; or your organization has no 10DLC brand. Nothing was ordered.

  • application/json
Request Example for post/v1/phone-number-orders
curl https://api.resia.ai/v1/phone-number-orders \
  --request POST \
  --header 'Content-Type: application/json' \
  --header 'Authorization: Bearer YOUR_SECRET_TOKEN' \
  --data '{
  "phone_number": "",
  "campaign_id": "6d40039b-0fc1-c114-c8e2-8a5294fd9941"
}'
{
  "phone_number_order_id": "string",
  "phone_number": "string",
  "status": "pending",
  "created_at": "2026-11-20T21:45:16.429Z",
  "updated_at": "2026-11-20T21:45:16.429Z"
}