Menu

Expand
Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?

Outgoing Caller ID Resource

An OutgoingCallerId resource represents a single verified number that may be used as a caller ID when making outgoing calls via the REST API and within the TwiML <Dial> verb.

Outgoing Caller IDs are created by adding verified phone numbers in the Twilio console and cannot be created via API. Any phone numbers that you purchase through the Twilio API are already available to be used as caller IDs for outbound calls.

Outgoing Caller ID resource properties

When retrieved via REST API, Outgoing Caller ID resources will have the following properties.

Names in PHP format
sid
sid<PN> Not PII

The unique string that that we created to identify the OutgoingCallerId resource.

dateCreated
date_time<rfc2822> Not PII

The date and time in GMT that the resource was created specified in RFC 2822 format.

dateUpdated
date_time<rfc2822> Not PII

The date and time in GMT that the resource was last updated specified in RFC 2822 format.

friendlyName

The string that you assigned to describe the resource.

accountSid
sid<AC> Not PII

The SID of the Account that created the OutgoingCallerId resource.

phoneNumber
phone_number PII MTL: 30 DAYS

The phone number in E.164 format, which consists of a + followed by the country code and subscriber number.

uri
uri Not PII

The URI of the resource, relative to https://api.twilio.com.

Fetch a single Outgoing Caller ID resource

get
https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/OutgoingCallerIds/{Sid}.json
Parameters
Names in None format
account_sid
Required
get sid<AC> Not PII

The SID of the Account that created the OutgoingCallerId resource to fetch.

sid
Required
get sid<PN> Not PII

The Twilio-provided string that uniquely identifies the OutgoingCallerId resource to fetch.

Example
        
        
        
        

        List multiple Outgoing Caller IDs

        get
        https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/OutgoingCallerIds.json
        Parameters
        Names in None format
        phone_number
        Optional
        get phone_number PII MTL: 30 DAYS

        The phone number of the OutgoingCallerId resources to read.

        friendly_name
        Optional
        get string PII MTL: 30 DAYS

        The string that identifies the OutgoingCallerId resources to read.

        account_sid
        Required
        get sid<AC> Not PII

        The SID of the Account that created the OutgoingCallerId resources to read.

        Example
              
              
              
              

              Update an Outgoing Caller ID resource

              post
              https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/OutgoingCallerIds/{Sid}.json
              Parameters
              Names in None format
              account_sid
              Required
              post sid<AC> Not PII

              The SID of the Account that created the OutgoingCallerId resources to update.

              sid
              Required
              post sid<PN> Not PII

              The Twilio-provided string that uniquely identifies the OutgoingCallerId resource to update.

              friendly_name
              Optional
              post string PII MTL: 30 DAYS

              A descriptive string that you create to describe the resource. It can be up to 64 characters long.

              Example
                    
                    
                    
                    

                    Delete an Outgoing Caller ID resource

                    delete
                    https://api.twilio.com/2010-04-01/Accounts/{AccountSid}/OutgoingCallerIds/{Sid}.json
                    Parameters
                    Names in None format
                    account_sid
                    Required
                    delete sid<AC> Not PII

                    The SID of the Account that created the OutgoingCallerId resources to delete.

                    sid
                    Required
                    delete sid<PN> Not PII

                    The Twilio-provided string that uniquely identifies the OutgoingCallerId resource to delete.

                    Example
                          
                          
                          
                          
                          Rate this page:

                          Need some help?

                          We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd browsing the Twilio tag on Stack Overflow.