Twilio

Twilio Numbers v1

This is the public Twilio REST API.

Communication#openapi

Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.

Overview

This is the public Twilio REST API.

Endpoints 20

NumbersV1BulkEligibility

  • POSTCreate a bulk eligibility check for a set of numbers that you want to host in Twilio./v1/HostedNumber/Eligibility/BulkCreate a bulk eligibility check for a set of numbers that you want to host in Twilio.
  • GETFetch an eligibility bulk check that you requested to host in Twilio./v1/HostedNumber/Eligibility/Bulk/:RequestIdFetch an eligibility bulk check that you requested to host in Twilio.

NumbersV1Eligibility

  • POSTCreate an eligibility check for a number that you want to host in Twilio./v1/HostedNumber/EligibilityCreate an eligibility check for a number that you want to host in Twilio.

NumbersV1PortingPortIn

  • POSTAllows to create a new port in request/v1/Porting/PortInAllows to create a new port in request
  • GETFetch a port in request by SID/v1/Porting/PortIn/:PortInRequestSidFetch a port in request by SID
  • DELETEAllows to cancel a port in request by SID/v1/Porting/PortIn/:PortInRequestSidAllows to cancel a port in request by SID
  • GETFetch all PortInRequests for a user/v1/Porting/PortIn/PortInRequests?Token=KWbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb&Size=20&PortInRequestSid=KW123abc12345678901234567890abcd&PortInRequestStatus=Completed&CreatedBefore=2025-05-05&CreatedAfter=2025-01-05Retrieve a list of all PortInRequests for a user

NumbersV1PortingPortInPhoneNumber

  • GETFetch a phone number by port in request SID and phone number SID/v1/Porting/PortIn/:PortInRequestSid/PhoneNumber/:PhoneNumberSidFetch a phone number by port in request SID and phone number SID
  • DELETEAllows to cancel a port in request phone number by SID/v1/Porting/PortIn/:PortInRequestSid/PhoneNumber/:PhoneNumberSidAllows to cancel a port in request phone number by SID

NumbersV1PortingPortability

  • GETCheck if a single phone number can be ported to Twilio/v1/Porting/Portability/PhoneNumber/:PhoneNumber?TargetAccountSid=ACaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa02&AddressSid=ADaaaaaaaaaaaaaaaaaaaaaaaaaaaaaa02Check if a single phone number can be ported to Twilio

NumbersV1PortingWebhookConfiguration

  • POSTCreate a Webhook Configuration/v1/Porting/Configuration/WebhookCreate a Webhook Configuration

NumbersV1PortingWebhookConfigurationDelete

  • DELETEAllows the client to delete a webhook configuration./v1/Porting/Configuration/Webhook/:WebhookTypeAllows the client to delete a webhook configuration.

NumbersV1PortingWebhookConfigurationFetch

  • GETAllows to fetch the webhook configuration/v1/Porting/Configuration/WebhookAllows to fetch the webhook configuration

NumbersV1SigningRequestConfiguration

  • GETSynchronous operation to retrieve configurations for the customer./v1/SigningRequest/Configuration?Country=MX&Product=Porting&PageSize=1&Page=0&PageToken=stringSynchronous operation to retrieve configurations for the customer.
  • POSTSynchronous operation to insert or update a configuration for the customer./v1/SigningRequest/ConfigurationSynchronous operation to insert or update a configuration for the customer.

NumbersV1SenderIdRegistration

  • POSTCreate Sender ID Registration/v1/SenderIdRegistrationsCreates a new sender ID registration and initializes an embedded Persona inquiry session. Returns registration details and embedded session credentials for…

NumbersV1SenderIdRegistrationEmbeddedSession

  • POSTCreate Embedded Session/v1/SenderIdRegistrations/:BundleSid/EmbeddedSessionsCreates a new embedded Persona inquiry session for an existing registration in DRAFT or TWILIO_REJECTED status. Use this to resume an incomplete registration…

V1CallerIds

  • POSTInitiate SMS verification for a caller ID/v1/CallerIds/SmsVerifications
  • POSTCheck SMS verification code/v1/CallerIds/SmsVerificationChecks
  • POSTInitiate voice verification for a caller ID/v1/CallerIds/VoiceVerifications

API details

Base URL
https://numbers.twilio.com
Authentication
HTTP Basic authentication (username and password)
Operations
20 operations on 16 pathsPOST 10GET 7DELETE 3
Main resources
NumbersV1PortingPortIn 4V1CallerIds 3NumbersV1BulkEligibility 2NumbersV1PortingPortInPhoneNumber 2NumbersV1SigningRequestConfiguration 2NumbersV1Eligibility 1NumbersV1PortingPortability 1NumbersV1PortingWebhookConfiguration 1NumbersV1PortingWebhookConfigurationDelete 1NumbersV1PortingWebhookConfigurationFetch 1
Response formats
application/json
Description format
OpenAPI 3.0.1, API version 1.0.0

How to test the Twilio Numbers v1 in Swastik Codes

  1. Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
  2. Fork it into your workspaceChoose a workspace. You get your own copy of the Twilio Numbers v1 collection, without the publisher's secrets.
  3. Add your credentialsThis API uses HTTP Basic authentication (username and password). Add yours in the collection's variables or an environment; the requests already reference it.
  4. Send a requestPick an endpoint, for example “Create a bulk eligibility check for a set of numbers that you want to host in Twilio.” (POST /v1/HostedNumber/Eligibility/Bulk), and press Send. Check the response, add tests and run the whole collection with the runner.

Frequently asked questions

What is the Twilio Numbers v1?

This is the public Twilio REST API. It is listed under Communication and has 20 endpoints.

Who publishes the Twilio Numbers v1?

It is listed from Twilio's public API description (an OpenAPI document), not published by Twilio on Swastik Codes. Anyone who controls twilio.com can claim the profile by adding a DNS TXT record.

What is the base URL of the Twilio Numbers v1?

Requests go to https://numbers.twilio.com. Endpoint paths are added to this base URL.

How do I authenticate with the Twilio Numbers v1?

With HTTP Basic authentication (username and password).

How many endpoints does the Twilio Numbers v1 have?

20 operations on 16 paths (10 POST, 7 GET, 3 DELETE). The largest groups are NumbersV1PortingPortIn, V1CallerIds, NumbersV1BulkEligibility, NumbersV1PortingPortInPhoneNumber.

Is forking the Twilio Numbers v1 free?

Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.

Suggest an API

Tell us which public API is missing. We check it, then add it here with its endpoints when it has an OpenAPI (Swagger) description.