POST
/
v1
/
number
/
buy
Buy number
curl --request POST \
  --url https://api.sendo.dev/v1/number/buy \
  --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"
}