POST
/
v1
/
number
/
buy
curl --request POST \
  --url https://api.sendo.dev/v1/number/buy \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "number": "<string>",
  "campaignId": "<string>"
}'
{
  "success": true,
  "status": "PENDING",
  "number": "+14155941075",
  "campaignId": "U7fQ3123"
}
This endpoint can only be used to purchase additional local phone numbers for a campaign that is already fully provisioned.

​
Body

​
number
string
required

The phone number to purchase in format.

​
campaignId
string
required

The ID of the campaign for the number.

​
Response

​
success
boolean
required

Whether the number was purchased successfully.

​
status
string

The status of the number after purchase.

​
number
string

The phone number that was purchased.

​
campaignId
string

The campaign ID attached to the number.

​
Charges

Your balance will be charged $2 for each active number on the date that the associated campaign renews. You can find the campaign renewal date on the Balance page of the Sendo dashboard.

Because of this, when you purchase a number, your balance will instantly be charged a prorated amount equal to the number of days remaining until the campaign renews (i.e. the next $2 charge).

{
  "success": true,
  "status": "PENDING",
  "number": "+14155941075",
  "campaignId": "U7fQ3123"
}