DID Object

The DID object describes a phone number assigned to an account, along with its formatting details and optional settings that control how FlexML requests and status callbacks are handled for calls involving that number. The object includes read-only identifiers and number formats, plus configurable fields such as the HTTP method, the url for FlexML instructions, and the status_callback_* settings used for end-of-call reporting.

DID Object Attributes

The fields listed in the table below will be returned in a JSON object when a successful request has been made.

Attribute	Data Type	Description
account_sid read only	string	The secure ID of the account to which the DID belongs.
country_code read only	string	The ISO 3166-1 alpha-3 code of the DID.
did_sid read only	string	The DID secure ID.
in_country_format read only	string	The DID in a national format.
international_format read only	string	The DID in an international format.
method update	string	The HTTP method used to execute the request. Values accepted in this field are POST or GET. The default value is POST.
phonenumber read only	string	The phone number for the DID in the E.164 format without the + prefix.
status_callback_method update	string	The method used to request status_callback_url. Values accepted in this field are POST or GET. The default value is POST.
status_callback_url update	string	If a URL is provided in this field, there will be a message at the end of calls involving this DID that provides information about the call. Assign this URL to obtain call length, etc.
url update	string	The URL where the instructions are located. If the url is not defined for a specific DID, the url from the Account object will be used.

Example DID Object

{
    "account_sid": "1d4adc32-45d1-4789-9780-928049e2bce1",
    "country_code": "USA",
    "did_sid": "d72c0ec3-c21d-4db1-8877-690cb9644fbc",
    "in_country_format": "(516) 206-5319",
    "international_format": "+1 516-206-5319",
    "method": "POST",
    "phonenumber": "15162065319",
    "status_callback_method": "POST",
    "status_callback_url": null,
    "url": null
}