canonical: https://jentic.com/apis/twilio.com/twilio---numbers

# Twilio - Numbers

This is the public Twilio REST API. The API exposes 14 endpoints secured with basic authentication.

## For AI agents

Programmatically create a bulk eligibility check for a set of numbers that you want to host in tw, fetch an eligibility bulk check that you requested to host in twilio.. Covers 14 operations with basic authentication.

## Scope

Does not handle payments, communications, or crm - use for developer tools only.

## Capabilities

- Create a bulk eligibility check for a set of numbers that you want to host in Tw
- Fetch an eligibility bulk check that you requested to host in Twilio.
- Allows to create a new port in request
- Query and filter Twilio - Numbers records by parameters
- Monitor Twilio - Numbers operational status and events

## Use cases

### Developer Tools Operations

Use the Twilio - Numbers to perform developer tools operations programmatically. The API provides 14 endpoints covering core functionality including create a bulk eligibility check for a set of numbers that you want to host in tw, fetch an eligibility bulk check that you requested to host in twilio., create an eligibility check for a number that you want to host in twilio..

Example prompt: Call POST /v1/HostedNumber/Eligibility/Bulk to create a bulk eligibility check for a set of numbers that you want to host in tw

### Automated NumbersV1AuthorizationDocument Management

Automate numbersv1authorizationdocument operations by combining multiple Twilio - Numbers endpoints. Agents can fetch an eligibility bulk check that you requested to host in twilio. and then create an eligibility check for a number that you want to host in twilio. in a single workflow.

Example prompt: Call GET /v1/HostedNumber/Eligibility/Bulk/{RequestId} to fetch an eligibility bulk check that you requested to host in twilio., then verify the result

### AI Agent Integration via Jentic

AI agents discover and call Twilio - Numbers endpoints through Jentic without managing credentials directly. An agent searches for the required operation by intent, receives the matching endpoint schema, and executes the call with Jentic-managed authentication. This eliminates the need to read API documentation or handle basic tokens manually.

Example prompt: Search Jentic for 'create a bulk eligibility check for a set of numbers that you want to host in tw', load the operation schema, and execute with Jentic-managed credentials

## Key endpoints

| Method | Path | Description |
| --- | --- | --- |
| POST | /v1/HostedNumber/Eligibility/Bulk | Create a bulk eligibility check for a set of numbers that you want to host in Tw |
| GET | /v1/HostedNumber/Eligibility/Bulk/{RequestId} | Fetch an eligibility bulk check that you requested to host in Twilio. |
| POST | /v1/HostedNumber/Eligibility | Create an eligibility check for a number that you want to host in Twilio. |
| POST | /v1/Porting/PortIn | Allows to create a new port in request |
| GET | /v1/Porting/PortIn/{PortInRequestSid} | Fetch a port in request by SID |
| DELETE | /v1/Porting/PortIn/{PortInRequestSid} | Allows to cancel a port in request by SID |
| GET | /v1/Porting/PortIn/{PortInRequestSid}/PhoneNumber/{PhoneNumberSid} | Fetch a phone number by port in request SID and phone number SID |
| DELETE | /v1/Porting/PortIn/{PortInRequestSid}/PhoneNumber/{PhoneNumberSid} | Allows to cancel a port in request phone number by SID |

## Key resources

- **NumbersV1AuthorizationDocument** — Operations related to NumbersV1AuthorizationDocument
- **NumbersV1BulkEligibility** — Operations related to NumbersV1BulkEligibility
- **NumbersV1DependentOrder** — Operations related to NumbersV1DependentOrder
- **NumbersV1Eligibility** — Operations related to NumbersV1Eligibility
- **NumbersV1HostedNumberOrder** — Operations related to NumbersV1HostedNumberOrder

## Why Jentic

- **Setup:** Wiring Twilio Numbers by hand means setting up HTTP basic auth with your Account SID and Auth Token, pointing at the numbers.twilio.com host, and handling pagination and retries across its hosted-number eligibility and porting operations yourself. Through Jentic you install once, import Twilio Numbers from the API Directory, store the Account SID and Auth Token once, and your agent calls it.
- **Permission scoping:** Twilio Numbers puts the port-in request and phone-number ids in the URL path (/v1/Porting/PortIn/{PortInRequestSid}/PhoneNumber/{PhoneNumberSid}), so a rule can pin your agent to one port-in request: it can read its status and phone numbers and nothing else. You choose the operations it may call, so destructive ones like deleting a port-in request are not included unless you add them.
- **Credential handling:** Your Twilio Account SID and Auth Token are stored once, encrypted, by your own Jentic One instance and injected at execution time. They never enter the agent's prompt, logs, or context.
- **Discovery method:** Agents search Jentic by intent such as 'create a bulk eligibility check for numbers to host in Twilio', and Jentic returns the matching Twilio Numbers operation with its input schema so the agent calls the right endpoint without browsing the reference docs.

## Related APIs

- **Github** — Alternative developer tools API
- **Gitlab** — Alternative developer tools API

## FAQ

### What authentication does the Twilio - Numbers use?

The Twilio - Numbers uses HTTP Basic authentication with username and password. Through Jentic, these credentials are stored encrypted in your Jentic One instance and injected at execution time, so raw secrets never enter the agent context.

### Can I create a bulk eligibility check for a set of numbers that you want to host in tw with the Twilio - Numbers?

Yes. Use the POST /v1/HostedNumber/Eligibility/Bulk endpoint. The API returns structured JSON responses that agents can parse and act on directly.

### What are the rate limits for the Twilio - Numbers?

Rate limits are not specified in the OpenAPI spec. Check the vendor documentation for current limits. Through Jentic, rate limiting is handled automatically with retry logic built into the execution layer.

### How do I create a bulk eligibility check for a set of numbers that you want to host in tw through Jentic?

Install the Jentic SDK with pip install jentic, authenticate through Jentic One, the self-hosted execution layer, then search for 'create a bulk eligibility check for a set of numbers that you want to host in tw'. Jentic returns the matching Twilio - Numbers operation with its input schema. Load the schema and execute the call - credentials are injected automatically.

### How many endpoints does the Twilio - Numbers have?

The Twilio - Numbers exposes 14 endpoints covering numbersv1authorizationdocument, numbersv1bulkeligibility, numbersv1dependentorder operations.

### Can I limit what my agent is allowed to do with the Twilio Numbers API?

Yes. Because Jentic One is self-hosted, you write the rules that decide which Twilio Numbers operations and credentials your agent may use. Twilio Numbers puts the port-in request and phone-number IDs in the URL path, such as /v1/Porting/PortIn/{PortInRequestSid}/PhoneNumber/{PhoneNumberSid}, so you can pin the agent to a single port-in request and let it read only that request's status and phone numbers. You choose the operations it can call, so destructive ones like canceling a port-in request stay out of reach unless you add them.