Phone ID Intelligence

overview and purpose the phone number intelligence api offers an advanced solution for assessing the risk profile of phone numbers by submitting a phone number, businesses can receive a comprehensive analysis of each identifier's risk level this service evaluates the provided information and generates a risk score, indicating the potential risk associated with the current transaction this api is designed to empower organizations with vital insights into transactional risks it not only provides a numeric risk score but also delivers a set of detailed insights and reason codes these elements offer granular and contextual intelligence, shedding light on the digital behavior that influences the risk score the primary goal of the phone number intelligence api is to enable businesses to make more informed decisions regarding transaction security by understanding the risk profiles of phone numbers, ip addresses, and email addresses, companies can effectively prevent fraudulent activities, verify user identities, and enhance the overall trustworthiness and security of their transactions use cases the phone number intelligence api serves a wide range of applications, each focused on enhancing security, managing risk, and fostering trust in different scenarios its versatility is evident in various sectors and operations fraud prevention it plays a crucial role in detecting and preventing fraudulent activities like account takeovers, identity theft, or fake account creation by analyzing the risk associated with phone numbers during registration or transactions identity verification the api assists in verifying the authenticity of a user's phone number, aligning it with the provided identity to diminish identity fraud risks transaction risk assessment in financial contexts, it evaluates the risk level of phone numbers involved in transactions, such as money transfers, helping to pinpoint potentially dubious activities user onboarding during new user registration processes, the api assesses the risk of the provided phone number, aiding in decision making for account creation approval or further scrutiny authentication and authorization it enhances security protocols by integrating phone number risk assessment into multi factor authentication systems, thereby preventing unauthorized access compliance and regulatory adherence the api is crucial in ensuring compliance with regulations, especially in industries with stringent requirements, by authenticating phone numbers and identifying associated risks account management for ongoing account maintenance, it continuously monitors phone numbers for risk, enabling proactive detection and response to suspicious activities telecommunications and mobile services telecommunication companies utilize this api to evaluate the risk associated with new phone number activations, aiming to detect and prevent misuse or fraud e commerce the api aids in preventing fraudulent transactions, account takeovers, and fake reviews by assessing the risk of phone numbers used in online purchases and reviews marketplace and classifieds it enhances the reliability of transactions in marketplaces and classifieds by verifying phone numbers of sellers and buyers, thereby reducing the chances of fraudulent listings and transactions countries supported below are the list of countries supporoted and the coverage they support true 309,309 unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type api details the api request will need an authorization token in the header the only input it needs is the phonenumber the phonenumber should also include country code sample curl curl location 'https //api preproduction signzy us/api/v3/global/risk score' \\ \ header 'authorization \<auth token>' \\ \ header 'content type application/json' \\ \ data '{ "phonenumber" "916xxxxxxxx5" }'curl location 'https //api signzy us/api/v3/global/risk score' \\ \ header 'authorization \<auth token>' \\ \ header 'content type application/json' \\ \ data '{ "phonenumber" "916xxxxxxxx5" }' request body parameters true 206,206,206 unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type detailed response { "result" { "completephonenumber" "11234567890", "countrycode" "1", "phonenumber" "1234567890", "riskinsights" { "category" \[ { "categorycode" "10010", "categoryname" "low activity ", "categorymeaning" "not enough activity or attributes to classify the transaction as either risky or trustworthy " } ], "applicationtopersonmessaging" \[ { "code" "22005", "codename" "seen in the last 15 days ", "codemeaning" "this number was seen in verification traffic in the last 15 days " }, { "code" "20011", "codename" "low long term activity ", "codemeaning" "low volume of verification traffic on this phone number over the past 90 days " }, { "code" "20013", "codename" "no range activity ", "codemeaning" "very little activity, or none at all, for a risky range that this number belongs to over the past 90 days also returned if the number does not belong to a risky range " } ], "numbertype" \[] }, "location" { "city" "", "state" "", "zip" "", "metrocode" "", "county" "", "country" { "name" "united states", "iso2" "us", "iso3" "usa" } }, "carrier" { "name" "at\&t wireless" }, "blocklisting" { "blocked" "", "blockcode" "", "blockdescription" "not blocked" }, "risk" { "level" "low", "recommendation" "allow", "score" 1 } } } response body parameters true 206,206,206left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type left unhandled content type reason codes the api returns specific reason codes that help in understanding the risk profile associated with a phone number these codes are categorized and each has a unique name and meaning category the reason codes are grouped under different categories each category reflects a certain aspect of the phone number's risk or behavior profile code every reason code is identified by a unique numerical value (e g , 10010 , 10020 ) this code is a key identifier used in the api response name each code has a corresponding name, which provides a brief label or title for the code (e g , "low activity", "low regular activity") meaning the meaning of each code offers a detailed explanation of what the code represents this description helps in understanding the specific aspect of the phone number's behavior or risk profile that the code is referring to (e g , "not enough activity or attributes to classify the transaction as either risky or trustworthy", "trustworthy category, based on past behavior") this mapping is crucial for interpreting the risk insights provided by the api, enabling businesses to make informed decisions based on the nuanced analysis of phone numbers used in transactions scoring logic true 154,154,154,156 unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type unhandled content type this table represents the risk scoring system used by the api, where a high score indicates a higher risk the 'recommendation' column suggests actions such as 'allow', 'flag', or 'block' based on the risk level, while the 'comments' column provides additional context for each score range sample error 400 bad request { "error" { "name" "error", "message" "phonenumber is required", "reason" "validation error", "type" "bad request", "statuscode" "400" } } 401 unauthorized { "message" "no api key found in request" } getting help please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better you can reach out to us at we strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively we value your feedback and are committed to making your experience smooth and enjoyable our team is dedicated to assisting you with any needs you may have thank you for choosing our services we look forward to helping you!