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
- Type: stringnullableX
- Resia - Organization - Id For Resia staff only. Omit it: your key acts on your own organization.
Body·
- Type: stringphone
_number required - Type: stringnullablecampaign
_id 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
- 402
insufficient_funds: your prepaid balance is $0.00 or less. Nothing was ordered. Add funds, then order again. - 404
not_found: no campaign with thatcampaign_idexists for your organization. Nothing was ordered. - 409
conflict: the carrier no longer has this number available; or thecampaign_idcampaign has no number pool and already holds 49 numbers; or your organization has no 10DLC brand. Nothing was ordered. - application/json
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"
}
