Phone ID - Identity attributes: Call Forwarding

📘

NOTE:

To add this feature to your account, contact a Telesign expert. This feature is available for full-service accounts only.

Use this identity attribute to get details related to the call forwarding status of a given phone number. These details include:

  • Whether call forwarding is enabled
  • Whether call forwarding is conditional
  • The conditions under which calls will be forwarded
  • You must include a consent record in your request indicating how and when you received consent to obtain information related to this phone number.

Example

A full request with this identity attribute is shown in the example below, as well as the extra package that the identity attribute includes in the response body.

Request

POST https://rest-ww.telesign.com/v1/phoneid/15555551212 HTTP/1.1
Authorization: Basic 12345678-9ABC-DEF0-1234-56789ABCDEF0:vjE/ZDfPvDkuGNsuqCFFO4neYIs=
Date: Thu, 12 Oct 2019 14:11:09 GMT
Content-Type: application/json 
{  
  "addons": {
    "call_forward_detection": {}
  },
  "consent": {
     "method": 1,
     "timestamp": "2018-05-01T00:30:30Z"
  }
}

Response (body only)

{
  "call_forward_detection": {
    "call_forward_enabled": "true",
    "call_forward_type": "conditional",
    "call_forward_condition": "busy",
    "status": {
      "code": 2800,
      "description": "Request successfully completed."
    }
  }
}

Schema

Request

ParameterTypeDescriptionExampleValidationsRequired?
addonsobjectIndicates which identity attributes you want to use with this request, and contains any other inputs for use with those identity attributes.y
addons.call_forward_detectionobjectServes as a flag to enable the Call Forwarding identity attribute. The value should be an empty object.y
consentobjectA record of how and when you obtained consent to query this phone number.y
consent.methodintegerA numeric code indicating how you collected consent to query this phone number. The default value is 1.

1 = Terms and conditions (TCO)
2 = Mobile app (MA)
3 = SMS
4 = OTHER
1Allowed Values:
1,2,3,4
n
consent.timestampstringA timestamp indicating the date and time when you collected consent to query this phone number.2018-05-01T00:30:30ZFormat: date-timey

Response

PropertyTypeDescriptionExample
call_forward_detectionobjectContains call forwarding status details for this phone number. Only present if you included the flag for the Call Forwarding identity attribute in your request and Telesign has enabled this identity attribute for your account.
call_forward_detection.call_forward_enabledstringWhether this phone number has call forwarding enabled.

"true" = It is enabled.
"false" = It is not enabled.
"true"
call_forward_detection.call_forward_typestringThe type of call forwarding enabled for this phone number. Conditional forwarding causes incoming calls to go to another phone line only when the initial destination phone number cannot be reached.conditional
call_forward_detection.call_forward_conditionstringThe conditions under which calls will be forwarded for this number. If the phone number uses unconditional call forwarding or has no call forwarding at all, the value will be "None".busy
statusobjectContains properties related to the delivery status of this package. For a list of possible statuses, see Phone ID - Get started with identity attributes.
status.codecodeA numeric code indicating the delivery status of this package.2800
status.descriptionstringA short description of the delivery status of this package.Request successfully completed.