post https://api.prembly.com/radar/api/v1/onboarding-screening/phone-intelligence
Phone Intelligence endpoint enables businesses to verify the accuracy of phone numbers and associated data of their customers
The following data points are collected during user onboarding:
- Number (mandatory)
Response Attributes
Attribute | Description | Response Type | Meaning |
---|---|---|---|
country_code | Two-letter ISO code of the mobile phone's registered country. | String | Example: US for United States. |
country_name | Name of the mobile phone's registered country. | String | Example: United States. |
phone_carrier | Mobile phone carrier associated with the phone number. | String | Example: Verizon, AT&T, etc. |
type | Type of phone number. | String | In this case, always "mobile". |
dial_code | Dial code for the mobile phone's country. | String | Example: +1 for the United States. |
local_format | Phone number in the format typically used within the country. | String | Example: (123) 456-7890 for US mobile numbers. |
international_format | Phone number in international format (E.164 format). | String | Example: +11234567890 for the US mobile number above. |
valid | Whether the phone number is a valid phone number according to the associated country's standards. | Boolean (True/False) | True indicates a valid number, False indicates an invalid number. |
active | Whether the phone number is currently active and able to receive calls/texts. | Boolean (True/False) | True indicates an active number, False indicates an inactive number. |
disposable | Whether the phone number is likely a disposable number (e.g., temporary phone number service). | Boolean (True/False) | True indicates a possible disposable number, False indicates likely not disposable. |
suspicious | Whether the phone number is flagged as suspicious based on screening criteria. | Boolean (True/False) | True indicates potential risk, False indicates no red flags found. |
simswap | Whether the phone number is suspected to be involved in a SIM swap (unauthorized transfer of phone number). | Boolean (True/False) | True indicates a possible SIM swap, False indicates no evidence of SIM swap. |
online_profiles | List of online profiles associated with the phone number (if any). | List | Currently always an empty list, indicating no linked profiles were found. Functionality for finding linked profiles might be added in the future. |
is_blacklisted | Whether the phone number is blacklisted for spam or other malicious activities. | Boolean (True/False) | True indicates a blacklisted number, False indicates not blacklisted. |