Twilio

Twilio HostedNumber API

The HostedNumber API from Twilio — 6 operation(s) for hostednumber.

GitHub OpenAPI
Business capability
Telecom Subscriber Management BC-2640

Operations 10

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

GET /v2/HostedNumber/AuthorizationDocuments/{Sid} Check a letter of authorization for hosting · Fetch authorization document #
Ask an LLM
“Has the letter of authorization for my hosted numbers been signed yet?”
“Can I look up one authorization document by its SID?”
Tell an agent
Fetch authorization document {document_sid}.
Show the signing status of LOA {document_sid}.
DELETE /v2/HostedNumber/AuthorizationDocuments/{Sid} Cancel an authorization document request · Delete authorization document #
Ask an LLM
“Can I withdraw a letter of authorization I sent out for signing?”
“What cancels a pending authorization document?”
Tell an agent destructive · confirm first
Cancel authorization document {document_sid}.
Withdraw the LOA signing request {document_sid}.
GET /v2/HostedNumber/AuthorizationDocuments List authorization documents · List authorization document #
Ask an LLM
“Which letters of authorization are still waiting to be signed?”
“Can I find the authorization documents sent to a particular email?”
Tell an agent
List authorization documents with status {status}.
List the authorization documents sent to {email}.
POST /v2/HostedNumber/AuthorizationDocuments Send a letter of authorization for signing · Create authorization document #
Ask an LLM
“How do I get the number owner to sign a letter of authorization for hosting?”
“Can one authorization document cover several hosted number orders?”
Tell an agent
Send an LOA to {email} covering orders {order_sids}, for address {address_sid} and contact number {contact_phone}.
Create an authorization document for orders {order_sids} signed by {email}, address {address_sid}, phone {contact_phone}, cc {cc_emails}.
GET /v2/HostedNumber/Orders/Bulk/{BulkHostingSid} Check a bulk number hosting order · Fetch bulk hosted number order #
Ask an LLM
“How far along is my bulk request to host many numbers?”
“Can I see only the failed numbers within a bulk hosting order?”
Tell an agent
Fetch bulk hosting order {bulk_sid}.
Show numbers in bulk hosting order {bulk_sid} with order status {order_status}.
GET /v2/HostedNumber/AuthorizationDocuments/{SigningDocumentSid}/DependentHostedNumberOrders List orders covered by an authorization document · List dependent hosted number order #
Ask an LLM
“Which hosted number orders depend on a given letter of authorization?”
“Can I filter the orders tied to one LOA by phone number or status?”
Tell an agent
List the hosted number orders covered by authorization document {document_sid}.
Find the order for {phone_number} under LOA {document_sid}.
GET /v2/HostedNumber/Orders/{Sid} Check a hosted number order · Fetch hosted number order #
Ask an LLM
“Where is my request to host a phone number in the verification process?”
“Can I look up a single hosted number order by SID?”
Tell an agent
Fetch hosted number order {order_sid}.
Show the current status of hosting order {order_sid}.
DELETE /v2/HostedNumber/Orders/{Sid} Cancel a hosted number order · Delete hosted number order #
Ask an LLM
“Can I cancel a number hosting request after submitting it?”
“At what status is it still possible to cancel a hosted number order?”
Tell an agent destructive · confirm first
Cancel hosted number order {order_sid}.
Withdraw the request to host a number under order {order_sid}.
GET /v2/HostedNumber/Orders List hosted number orders · List hosted number order #
Ask an LLM
“Which of my number hosting orders are still pending verification?”
“Can I find the hosting order for a specific phone number?”
Tell an agent
List my hosted number orders with status {status}.
Find the hosting order for phone number {phone_number}.
POST /v2/HostedNumber/Orders Host an existing phone number's SMS · Create hosted number order #
Ask an LLM
“How do I bring SMS for a number I already own onto the platform without porting it?”
“Can I set the SMS webhook URL when I request hosting for a number?”
Tell an agent
Host SMS for {phone_number}, owner {email}, contact {contact_phone}, address {address_sid}.
Request hosting of {phone_number} for owner {email} at address {address_sid}, contact {contact_phone}, sending inbound SMS to {sms_url}.

Documentation

📖
Documentation
https://www.twilio.com/docs/iam/api/account
📖
Documentation
https://www.twilio.com/en-us/blog/insights/ai/what-is-intelligent-virtual-assistant
📖
Documentation
https://www.twilio.com/docs
📖
Documentation
https://www.twilio.com/docs/conversations
📖
Documentation
https://www.twilio.com/docs/marketplace
📖
Documentation
https://www.twilio.com/en-us/messaging
📖
Documentation
https://www.twilio.com/en-us/user-authentication-identity/verify
📖
Documentation
https://www.twilio.com/docs/video
📖
Documentation
https://www.twilio.com/en-us/voice
📖
Documentation
https://www.twilio.com/docs/lookup
📖
Documentation
https://www.twilio.com/docs/flex
📖
Documentation
https://www.twilio.com/docs/sendgrid

Specifications

⚙
OpenAPI
https://artifacts.apis.io/twilio/openapi/twilio-hostednumber-api-openapi.yml
⚙
AsyncAPI
https://artifacts.apis.io/twilio/asyncapi/twilio-asyncapi.yml

Schemas & Data

📊
JSONSchema
https://artifacts.apis.io/twilio/json-schema/twilio-numbers-v2-hosted-number-order-schema.json
📊
JSONSchema
https://artifacts.apis.io/twilio/json-schema/twilio-create-hosted-number-order-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/twilio/json-schema/twilio-numbers-v2-bulk-hosted-number-order-schema.json
📊
JSONSchema
https://artifacts.apis.io/twilio/json-schema/twilio-numbers-v2-authorization-document-schema.json
📊
JSONSchema
https://artifacts.apis.io/twilio/json-schema/twilio-create-authorization-document-request-schema.json
📊
JSONSchema
https://artifacts.apis.io/twilio/json-schema/twilio-list-dependent-hosted-number-order-response-schema.json

Other Resources

🔗
Pricing
https://www.twilio.com/en-us/messaging/pricing/conversations-api
🔗
Pricing
https://www.twilio.com/en-us/sms/pricing/us
🔗
Pricing
https://www.twilio.com/en-us/verify/pricing
🔗
Pricing
https://www.twilio.com/en-us/video/pricing
🔗
Pricing
https://www.twilio.com/en-us/voice/pricing/us
🔗
Pricing
https://www.twilio.com/en-us/user-authentication-identity/pricing/lookup
🔗
Pricing
https://www.twilio.com/en-us/flex/pricing
🔗
Pricing
https://www.twilio.com/en-us/products/email-api/pricing

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/twilio:twilio-hostednumber-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

twilio-hostednumber-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  title: Twilio - Numbers Hosted Number API
  description: This is the public Twilio REST API.
  termsOfService: https://www.twilio.com/legal/tos
  contact:
    name: Twilio Support
    url: https://support.twilio.com
    email: support@twilio.com
  license:
    name: Apache 2.0
    url: https://www.apache.org/licenses/LICENSE-2.0.html
  version: 1.52.0
servers:
- url: https://numbers.twilio.com
tags:


# --- truncated at 32 KB (38 KB total) ---
# Full source: https://artifacts.apis.io/twilio/openapi/twilio-hostednumber-api-openapi.yml