DID Line Information Object

The DID Line Information Object contains the caller identification and line presentation details associated with a DID (phone number). It defines how the caller's information—such as name, business details, and privacy preferences—appears to receiving parties.

This object also includes configuration fields that control the type of service (business or residential), call screening behavior, and whether the caller name record is active in the CNAM registry. Together, these settings determine how the line is displayed and handled in outbound calls.

DID Line Information Object Attributes

These fields and values make up the JSON response that gets returned when a request is successful.

info

To enable this feature on your account, contact technical support at support@carrierx.com.

Attribute	Data Type	Description
caller_name update	string	The name that will appear on receiving party phones.
class_of_service update	string	The type of establishment that the service is for. Values accepted in this field are: business none residential The default value is none.
enabled update	boolean	If this field is set to false, no record is stored in the central CNAM registry. Fields can still be updated when the value is false.
extended_business_name update	string	The business name associated with the caller. This extended information is given according to the provider and phone device.
extended_first_name update	string	The first name of the caller. This extended information is given according to the provider and phone device.
extended_last_name update	string	The last name of the caller. This extended information is given according to the provider and phone device.
privacy update	string	Either public or private. This is whether or not the caller name will be displayed. The default is public.
screening update	string	Determines what types of calls are accepted. Values accepted in this field are: allow_all to allow all calls. block_collect to block collect calls. block_third_number to block third number (operator assisted) calls. block_third_number_collect to block third number (operator assisted) and collect calls. The default value is block_third_number_collect.

Sample DID Line Information Object

{
    "caller_name": "John Smith",
    "class_of_service": "business",
    "enabled": true,
    "extended_business_name": "J Smith Carpenter",
    "extended_first_name": "John",
    "extended_last_name": "Smith",
    "privacy": "public",
    "screening": "allow_all"
}