# Twilio - Numbers API

> Twilio - Numbers API on Apizie: 47 endpoints (Fetch a specific AuthorizationDocument., Cancel the AuthorizationDocument request., Retrieve a list of AuthorizationDocuments belonging to the account initiating the request., Create an AuthorizationDocument for authorizing the hosting of phone number capabilities on Twilio's platform., …) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `communication:twilio-twilio-numbers-v2`
- Category: Communication
- Status: byok
- Source: https://support.twilio.com
- Page: https://apizie.tech/api/communication/twilio-twilio-numbers-v2
- OpenAPI: https://apizie.tech/api/communication/twilio-twilio-numbers-v2/openapi.json

This is the public Twilio REST API.

## Endpoints

### Fetch a specific AuthorizationDocument.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/fetch-authorization-document` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | A 34 character string that uniquely identifies this AuthorizationDocument. |

### Cancel the AuthorizationDocument request.
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/delete-authorization-document` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | A 34 character string that uniquely identifies this AuthorizationDocument. |

### Retrieve a list of AuthorizationDocuments belonging to the account initiating the request.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/list-authorization-document` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Email | string | no | Email that this AuthorizationDocument will be sent to for signing. |
| Status | string | no | Status of an instance resource. It can hold one of the values: 1. opened 2. signing, 3. signed LOA, 4. canceled, 5. failed. See the… |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Create an AuthorizationDocument for authorizing the hosting of phone number capabilities on Twilio's platform.
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/create-authorization-document` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch a specific BulkHostedNumberOrder.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/fetch-bulk-hosted-number-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| BulkHostingSid | string | yes | A 34 character string that uniquely identifies this BulkHostedNumberOrder. |
| OrderStatus | string | no | Order status can be used for filtering on Hosted Number Order status values. To see a complete list of order statuses, please check… |

### Host multiple phone numbers on Twilio's platform.
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/create-bulk-hosted-number-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | JSON request body |

### Retrieve a list of all Bundles for an account.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/list-bundle` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Status | string | no | The verification status of the Bundle resource. Please refer to [Bundle… |
| BundleSids | string | no | A comma-separated list of Bundle SIDs to filter the results (maximum 20). Each Bundle SID must match `^BU[0-9a-fA-F]{32}$`. |
| FriendlyName | string | no | The string that you assigned to describe the resource. The column can contain 255 variable characters. |
| RegulationSid | string | no | The unique string of a [Regulation resource](https://www.twilio.com/docs/phone-numbers/regulatory/api/regulations) that is associated to… |
| IsoCountry | string | no | The 2-digit [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the Bundle's phone number country ownership request. |
| NumberType | string | no | The type of phone number of the Bundle's ownership request. Can be `local`, `mobile`, `national`, or `toll-free`. |
| EndUserType | string | no | The end user type of the regulation of the Bundle. Can be `business` or `individual`. |
| HasValidUntilDate | boolean | no | Indicates that the Bundle is a valid Bundle until a specified expiration date. |
| SortBy | string | no | Can be `valid-until` or `date-updated`. Defaults to `date-created`. |
| SortDirection | string | no | Default is `DESC`. Can be `ASC` or `DESC`. |
| ValidUntilDate | string | no | Date to filter Bundles having their `valid_until_date` before or after the specified date. Can be `ValidUntilDate>=` or… |
| ValidUntilDate< | string | no | Date to filter Bundles having their `valid_until_date` before or after the specified date. Can be `ValidUntilDate>=` or… |
| ValidUntilDate> | string | no | Date to filter Bundles having their `valid_until_date` before or after the specified date. Can be `ValidUntilDate>=` or… |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Create a new Bundle.
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/create-bundle` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch a specific Bundle instance.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/fetch-bundle` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The unique string that we created to identify the Bundle resource. |

### Updates a Bundle in an account.
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/update-bundle` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The unique string that we created to identify the Bundle resource. |
| body | object | no | Form fields as a JSON object |

### Delete a specific Bundle.
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/delete-bundle` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The unique string that we created to identify the Bundle resource. |

### Creates a new clone of the Bundle in target Account. It will internally create clones of all the bundle…
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/create-bundle-clone` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| BundleSid | string | yes | The unique string that identifies the Bundle to be cloned. |
| body | object | no | Form fields as a JSON object |

### Retrieve a list of all Bundles Copies for a Bundle.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/list-bundle-copy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| BundleSid | string | yes | The unique string that we created to identify the Bundle resource. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Creates a new copy of a Bundle. It will internally create copies of all the bundle items (identities and…
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/create-bundle-copy` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| BundleSid | string | yes | The unique string that identifies the Bundle to be copied. |
| body | object | no | Form fields as a JSON object |

### Retrieve a list of dependent HostedNumberOrders belonging to the AuthorizationDocument.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/list-dependent-hosted-number-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| SigningDocumentSid | string | yes | A 34 character string that uniquely identifies the LOA document associated with this HostedNumberOrder. |
| Status | string | no | Status of an instance resource. It can hold one of the values: 1. opened 2. signing, 3. signed LOA, 4. canceled, 5. failed. See the… |
| PhoneNumber | string | no | An E164 formatted phone number hosted by this HostedNumberOrder. |
| IncomingPhoneNumberSid | string | no | A 34 character string that uniquely identifies the IncomingPhoneNumber resource created by this HostedNumberOrder. |
| FriendlyName | string | no | A human readable description of this resource, up to 128 characters. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Retrieve a list of all End User for an account.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/list-end-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Create a new End User.
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/create-end-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch specific End User Instance.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/fetch-end-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The unique string created by Twilio to identify the End User resource. |

### Update an existing End User.
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/update-end-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The unique string created by Twilio to identify the End User resource. |
| body | object | no | Form fields as a JSON object |

### Delete a specific End User.
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/delete-end-user` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The unique string created by Twilio to identify the End User resource. |

### Retrieve a list of all End-User Types.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/list-end-user-type` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Fetch a specific End-User Type Instance.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/fetch-end-user-type` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The unique string that identifies the End-User Type resource. |

### Retrieve a list of Evaluations associated to the Bundle resource.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/list-evaluation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| BundleSid | string | yes | The unique string that identifies the Bundle resource. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Creates an evaluation for a bundle
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/create-evaluation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| BundleSid | string | yes | The unique string that identifies the Bundle resource. |

### Fetch specific Evaluation Instance.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/fetch-evaluation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| BundleSid | string | yes | The unique string that we created to identify the Bundle resource. |
| Sid | string | yes | The unique string that identifies the Evaluation resource. |

### Fetch a specific HostedNumberOrder.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/fetch-hosted-number-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | A 34 character string that uniquely identifies this HostedNumberOrder. |

### Updates a specific HostedNumberOrder.
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/update-hosted-number-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The SID of the HostedNumberOrder resource to update. |
| body | object | no | Form fields as a JSON object |

### Cancel the HostedNumberOrder (only available when the status is in `received`).
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/delete-hosted-number-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | A 34 character string that uniquely identifies this HostedNumberOrder. |

### Retrieve a list of HostedNumberOrders belonging to the account initiating the request.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/list-hosted-number-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Status | string | no | The Status of this HostedNumberOrder. One of `received`, `pending-verification`, `verified`, `pending-loa`, `carrier-processing`,… |
| SmsCapability | boolean | no | Whether the SMS capability will be hosted on our platform. Can be `true` of `false`. |
| PhoneNumber | string | no | An E164 formatted phone number hosted by this HostedNumberOrder. |
| IncomingPhoneNumberSid | string | no | A 34 character string that uniquely identifies the IncomingPhoneNumber resource created by this HostedNumberOrder. |
| FriendlyName | string | no | A human readable description of this resource, up to 128 characters. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Host a phone number's capability on Twilio's platform.
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/create-hosted-number-order` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Retrieve a list of all Assigned Items for an account.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/list-item-assignment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| BundleSid | string | yes | The unique string that we created to identify the Bundle resource. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Create a new Assigned Item.
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/create-item-assignment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| BundleSid | string | yes | The unique string that we created to identify the Bundle resource. |
| body | object | no | Form fields as a JSON object |

### Fetch specific Assigned Item Instance.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/fetch-item-assignment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| BundleSid | string | yes | The unique string that we created to identify the Bundle resource. |
| Sid | string | yes | The unique string that we created to identify the Identity resource. |

### Remove an Assignment Item Instance.
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/delete-item-assignment` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| BundleSid | string | yes | The unique string that we created to identify the Bundle resource. |
| Sid | string | yes | The unique string that we created to identify the Identity resource. |

### Retrieve a list of all Regulations.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/list-regulation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| EndUserType | string | no | The type of End User the regulation requires - can be `individual` or `business`. |
| IsoCountry | string | no | The ISO country code of the phone number's country. |
| NumberType | string | no | The type of phone number that the regulatory requiremnt is restricting. |
| IncludeConstraints | boolean | no | A boolean parameter indicating whether to include constraints or not for supporting end user, documents and their fields |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Fetch specific Regulation Instance.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/fetch-regulation` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The unique string that identifies the Regulation resource. |
| IncludeConstraints | boolean | no | A boolean parameter indicating whether to include constraints or not for supporting end user, documents and their fields |

### Replaces all bundle items in the target bundle (specified in the path) with all the bundle items of the…
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/create-replace-items` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| BundleSid | string | yes | The unique string that identifies the Bundle where the item assignments are going to be replaced. |
| body | object | no | Form fields as a JSON object |

### Retrieve a list of all Supporting Document for an account.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/list-supporting-document` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Create a new Supporting Document.
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/create-supporting-document` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | no | Form fields as a JSON object |

### Fetch specific Supporting Document Instance.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/fetch-supporting-document` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The unique string created by Twilio to identify the Supporting Document resource. |

### Update an existing Supporting Document.
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/update-supporting-document` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The unique string created by Twilio to identify the Supporting Document resource. |
| body | object | no | Form fields as a JSON object |

### Delete a specific Supporting Document.
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/delete-supporting-document` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The unique string created by Twilio to identify the Supporting Document resource. |

### Retrieve a list of all Supporting Document Types.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/list-supporting-document-type` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 1000. |
| Page | integer | no | The page index. This value is simply for client state. |
| PageToken | string | no | The page token. This is provided by the API. |

### Fetch a specific Supporting Document Type Instance.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/fetch-supporting-document-type` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| Sid | string | yes | The unique string that identifies the Supporting Document Type resource. |

### List Short Code Applications
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/list-short-code-applications` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| AccountSid | string | no | The Account SID to filter by. |
| IsoCountry | string | no | The ISO country to filter by. |
| Status | string | no | The application status to filter by. |
| FriendlyName | string | no | The friendly name to filter by. |
| Sid | string | no | The application SID to filter by. |
| PageSize | integer | no | How many resources to return in each list page. The default is 50, and the maximum is 50. |
| Page | integer | no | The current page. |

### Create a new short code application
`POST https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/create-short-code-application` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| body | object | yes | JSON request body |

### Fetch a specific Short Code Application instance.
`GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/fetch-short-code-application` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| sid | string | yes | The unique string that identifies the Short Code Application resource. |

## Example
```
curl "https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/fetch-authorization-document" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Twilio - Numbers API?
Create a free Apizie key, then send GET https://apizie.tech/v1/communication:twilio-twilio-numbers-v2/fetch-authorization-document with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Twilio - Numbers API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Twilio - Numbers itself also needs your own key from twilio.

### Can AI agents use the Twilio - Numbers API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key communication:twilio-twilio-numbers-v2.

### What is the status of the Twilio - Numbers API?
Needs your own provider key (bring your own key)