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

# Buy Phone Number

> Purchase a phone number from Twilio

## Request

```bash theme={null}
curl -X POST https://app.orova.ai/api/phone-numbers/buy \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "phoneNumber": "+12125551234",
    "workspaceId": "WORKSPACE_ID"
  }'
```

## Parameters

| Field         | Type   | Required | Description                         |
| ------------- | ------ | -------- | ----------------------------------- |
| `phoneNumber` | string | Yes      | Number to buy (from search results) |
| `workspaceId` | string | Yes      | Workspace ID                        |

## Response

```json theme={null}
{
  "_id": "phone_id",
  "number": "+12125551234",
  "status": "active",
  "workspaceId": "WORKSPACE_ID"
}
```