SMPP TLVs for SMS Verify

These TLVs are supported only when using SMPP to hit the TeleSign SMS Verify API. They are grouped according to which product feature they are related to.

If you haven’t already, first review SMPP Protocol to learn our general SMPP requirements before reading this page.

Score Check

These TLVs are related to Score, the feature which returns a score to help determine how likely it is that the number is associated with fraudulent activities. Ask our Customer Support Team if you would like to enable this feature.

phone_type

The type of the phone number in the request. May be included in the deliver_sm PDU sent in response to a Score request.

Field Octets Size Type Description
Parameter Tag 2 Integer 0x1407
Length 2 Integer Length of Value field in octets
Value 2 Octet-String Contains these sub-fields:
code (phone type code)
description (the phone type)

Example: "code:2; description:MOBILE"

risk_score

The score and associated data for the phone number in the request. May be included in the deliver_sm PDU sent in response to a Score request.

Field Octets Size Type Description
Parameter Tag 2 Integer 0x1408
Length 2 Integer Length of Value field in octets
Value 2 C-Octet String Contains these sub-fields:
level (a description of the severity of the risk), score (the risk core itself)
recommendation (the action TeleSign recommends you take based on the risk score)

Example: "level:low; score:1; recommendation:allow"

numbering

The original phone number from the request, along with some additional details.

Field Size Octets Type Description
Parameter Tag 2 Integer 0x1409
Length 2 Integer Length of Value field in octets
Value 2 C-Octet String Contains these sub-fields:
phone_number (the phone number without the country dialing code)
min_length (the minimum number of digits allowed for phone numbers with this country dialing code)
max_length (the maximum number of digits allowed for phone numbers with this country dialing code)
country_code (a 1, 2, or 3-digit number representing the country dialing code for this phone number)

Example: "phone_number:5558675309; min_length:5; max_length:15; country_code:1"