> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sendo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Buy number

> Purchase a number for a campaign.

<Tip>This endpoint can only be used to purchase additional **local** phone numbers for a campaign that is already fully provisioned.</Tip>

### Body

<ParamField body="number" type="string" required>
  The [phone number](/api-reference/number/search) to purchase in <Tooltip tip="I.e. +14155552671. Must start with +1 and be followed by the 10 digit number with no spaces or special characters.">E.164</Tooltip> format.
</ParamField>

<ParamField body="campaignId" type="string" required>
  The ID of the campaign for the number.
</ParamField>

### Response

<ResponseField name="success" type="boolean" required>
  Whether the number was purchased successfully.
</ResponseField>

<ResponseField name="status" type="string">
  The status of the number after purchase.
</ResponseField>

<ResponseField name="number" type="string">
  The phone number that was purchased.
</ResponseField>

<ResponseField name="campaignId" type="string">
  The campaign ID attached to the number.
</ResponseField>

### 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).

<ResponseExample>
  ```json Success theme={null}
  {
    "success": true,
    "status": "PENDING",
    "number": "+14155941075",
    "campaignId": "U7fQ3123"
  }
  ```

  ```json Error theme={null}
  {
    "success": false,
    "error": "Number not available"
  }
  ```
</ResponseExample>