SMS Verify - SMPP TLVs
NOTE:
To add this product to your account, contact a Telesign expert. This product is available for full-service accounts only.
These TLVs are supported only when using SMPP to query Telesign SMS Verify. 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 Telesign product which returns a risk score to help determine how likely it is that the number is associated with fraudulent activities. Ask the Telesign Customer Support Team if you would like to enable this feature for SMS Verify.
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 score itself)• recommendation (the action TeleSign recommends you take based on the risk score) Example: "level:low; score:1; recommendation:allow" |
risk_insights
Contains reason code sub-fields with additional info related to the risk score. Score API - Insights reason code mappings provides the meaning of these reason codes.
| Field | Octets Size | Type | Description |
|---|---|---|---|
| Parameter Tag | 2 | Integer | 0x140A |
| Length | 2 | Integer | Length of Value field in octets |
| Value | 2 | C-Octet String | Contains these sub-fields: • status (The processing status of the risk insights package for this request.)• category (Reason codes related to the category of the phone number.)• a2p (Reason codes specific to application-to-person communication (A2P). These are automated communications sent to a human, like verification codes, appointment reminders, etc.) • p2p (Reason codes specific to person-to-person communication (P2P). This is two-way communication between two humans, like one friend texting another.) • numberType (Reason codes related to the phone number’s type.) Example: "status:800; category:[10040]; a2p:[22001, 20012, 20101]; p2p:[30201]; numberType:[40004, 40013]" |
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" |
Updated 5 days ago