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. |
