Phone Insights Score - Advance

introduction the phone insights score advance api provides a comprehensive risk assessment of a user based solely on their phone number it aggregates data from carrier records, porting history, sim activity, and multiple events to generate a trust score that reflects the reliability and authenticity of the user’s phone identity this api is a powerful tool for fraud prevention, risk profiling, and enhancing decision making during user onboarding or transaction verification a higher score indicates higher trustworthiness and lower risk associated with the phone number key benefits real time phone based risk scoring for fraud detection enhanced onboarding decisions using trusted telecom data reduced manual checks with automated risk signals seamless integration into kyc and fraud prevention workflows common use cases fintech & lending risk assessment evaluate risk of identity fraud before approving loans or credit using phone based risk indicators e commerce transaction verification use phone trust score to flag high risk users or transactions during checkout fraud prevention in digital wallets detect fraud or recently ported numbers before allowing sensitive actions like money transfers or password resets customer onboarding in telecom & utilities assess user legitimacy based on deactivation patterns and sim activity before issuing services authentication & login flows use score as an additional risk signal to trigger step up authentication or challenge mechanisms ride sharing, gig, or rental platforms quickly assess the trust level of new users or drivers/renters through phone number intelligence sample curl curl location 'https //api signzy us/api/v3/us kyc/phone insights score advanced' \\ \ header 'content type application/json' \\ \ header 'authorization \<auth token>' \\ \ data '{ { "phonenumber" "\<phone number>", "consentstatus" "\<consent status>", "consentoptintype" "\<consent optin type>", "consentoptinmethod" "\<consent optin method>", "consentoptinduration" "\<consent optin duration>", "consentoptinid" "\<consent optin id>", "consentoptintimestamp" "\<consent optin timestamp>", "options" { "carrierinfo" "\<true or false>", "portinginfo" "\<true or false>", "deactinfo" "\<true or false>", "callhandlinginfo" "\<true or false>", "acctinfo" "\<true or false>", "simchangeinfo" "\<true or false>", "imeichangeinfo" "\<true or false>", "simactivity" "\<true or false>", "phoneactivity" "\<true or false>", "navactivity" "\<true or false>", "acctchangeinfo" "\<true or false>", "phonetrustscore" "\<true or false>" } }'curl location 'https //api preproduction signzy us/api/v3/us kyc/phone insights score advanced' \\ \ header 'content type application/json' \\ \ header 'authorization \<auth token>' \\ \ data '{ { "phonenumber" "\<phone number>", "consentstatus" "\<consent status>", "consentoptintype" "\<consent optin type>", "consentoptinmethod" "\<consent optin method>", "consentoptinduration" "\<consent optin duration>", "consentoptinid" "\<consent optin id>", "consentoptintimestamp" "\<consent optin timestamp>", "options" { "carrierinfo" "\<true or false>", "portinginfo" "\<true or false>", "deactinfo" "\<true or false>", "callhandlinginfo" "\<true or false>", "acctinfo" "\<true or false>", "simchangeinfo" "\<true or false>", "imeichangeinfo" "\<true or false>", "simactivity" "\<true or false>", "phoneactivity" "\<true or false>", "navactivity" "\<true or false>", "acctchangeinfo" "\<true or false>", "phonetrustscore" "\<true or false>" } }' request body parameters key type mandatory description consentstatus string true consent status of the phone number allowed values optedin, optedout, notcollected, unknown, y, n phonenumber string true phone number in 11 digit format starting with 1 pattern 1xxxxxxxxxx (1 = country code, next 10 digits = number) consentoptintype string true must be "whitelist" (case insensitive) accepted whitelist / whitelist / whitelist consentoptinmethod string true method of consent collection allowed values tco, ma, tcp, ivr, sms, other consentoptinduration string true indicates duration of consent allowed values one (single use), ong (ongoing) consentoptinid string true alphanumeric identifier representing consumer's opt in id special characters allowed (but must contain at least one alphanumeric character) consentoptinurl string false url where the user provided consent optional and may be an empty string consentoptintimestamp string true timestamp in iso 8601 utc format yyyy mm ddthh\ mm\ ss sssz validation rules • must be a valid iso timestamp• cannot be in the future• must be within last 5 years options object true object containing optional flags indicating which data attributes should be fetched all child fields accept "true" or "false" options parameters key type mandatory description carrierinfo string ("true"/"false") optional include carrier information portinginfo string optional include porting/number portability details deactinfo string optional include deactivation history callhandlinginfo string optional include call routing / handling information acctinfo string optional include account level information simchangeinfo string optional include sim change events imeichangeinfo string optional include imei change events simactivity string optional include sim activity details phoneactivity string optional include phone activity information navactivity string optional include network activity history acctchangeinfo string optional include account change events phonetrustscore string optional include trust score of the device sample response response { "result" { "datetime" "\<response datetime>", "trxid" "\<transaction id>", "status" "\<status>", "errorlist" \[ { "message" "\<error message>", "detailmessage" "\<error detail>", "info" "\<error info>" }, { "message" "\<error message>", "detailmessage" "\<error detail>", "info" "\<error info>" } ], "mdn" "\<mdn phone number>", "subscriber" { "identifier" { "sim" { "tenure" { "mindays" "\<sim tenure min days>", "maxdays" "\<sim tenure max days>" } } }, "callhandlinginfo" { "callforwarding" "\<call forwarding status>" }, "nametenure" { "mindays" "\<name tenure min days>" } }, "account" { "accttypescore" "\<account type score>", "accttenure" { "min" "\<account tenure min>" }, "mdntenure" { "mindays" "\<mdn tenure min days>" }, "servicestatustenure" { "mindays" "\<service status tenure min days>" }, "linetype" "\<line type>", "servicetypescore" "\<service type score>", "servicestatusscore" "\<service status score>", "primaryacctholderscore" "\<primary account holder score>", "portinginfo" { "ported" "\<ported status>", "tenure" { "mindays" "\<porting tenure min days>" }, "lastcarrier" { "name" "\<port last carrier name>", "originalname" "\<port last carrier original name>" } }, "deactinfo" { "lastdeactdate" "\<last deact date>", "lastcarriername" "\<last deact carrier name>", "lastdeacttype" "\<last deact type>" }, "smscapable" "\<sms capable>", "smsserviceprovider" "\<sms provider>" }, "carrier" { "name" "\<carrier name>", "originalname" "\<carrier original name>", "ocn" "\<carrier ocn>", "mcc" "\<carrier mcc>", "mnc" "\<carrier mnc>" }, "device" { "identifier" { "imei" { "tenure" { "mindays" "\<imei tenure min days>", "maxdays" "\<imei tenure max days>" } } } }, "scores" { "phonetrust" { "value" "\<phone trust score>" } }, "activitylist" \[ { "type" "\<activity type>", "lookbackdays" "\<lookback days>", "score" "\<activity score>" } ] }, "reason" "\<reason message>", "code" "\<status code>" } response body parameters key type description result object contains the entire response data returned from the provider result datetime string (iso 8601) timestamp of when the response was generated result trxid string unique transaction identifier for the request result status string indicates overall response status (e g , success, partial success, failure) result errorlist array list of errors for individual data sections that were unavailable or failed result errorlist\[] message string error type or error code result errorlist\[] detailmessage string specific option or field for which data was not available result errorlist\[] info string human readable explanation of the error result mdn string mobile device number (phone number) processed in the request result subscriber object contains subscriber level information result subscriber identifier object identifier related details of the subscriber result subscriber identifier sim object sim information for the subscriber result subscriber identifier sim tenure object duration the sim has been active result subscriber identifier sim tenure mindays string minimum sim tenure (in days) result subscriber identifier sim tenure maxdays string maximum sim tenure (in days) result subscriber callhandlinginfo object details regarding call forwarding or call handling result subscriber callhandlinginfo callforwarding string indicates whether call forwarding is enabled result subscriber nametenure object tenure for the subscriber name on the account result subscriber nametenure mindays string minimum days the current name has been associated with the account result account object account level information of the subscriber’s carrier profile result account accttypescore string score representing the type of account result account accttenure object tenure of the account result account accttenure min string minimum account tenure result account mdntenure object tenure for the phone number on the account result account mdntenure mindays string minimum phone number tenure result account servicestatustenure object duration of the current service status result account servicestatustenure mindays string minimum days in the current service status result account linetype string type of phone line (wireless, voip, landline, etc ) result account servicetypescore string score representing service type result account servicestatusscore string score representing account service status result account primaryacctholderscore string score indicating whether the user is the primary account holder result account portinginfo object information about number porting activity result account portinginfo ported string indicates if the number was ported result account portinginfo tenure mindays string minimum days since number was ported result account portinginfo lastcarrier name string short name of the previous carrier result account portinginfo lastcarrier originalname string full original name of the previous carrier result account deactinfo object information about account or number deactivation events result account deactinfo lastdeactdate string last deactivation date result account deactinfo lastcarriername string carrier associated with the deactivation result account deactinfo lastdeacttype string type of deactivation result account smscapable string indicates if the number is sms capable result account smsserviceprovider string sms service provider for the number result carrier object carrier information for the phone number result carrier name string carrier name (short) result carrier originalname string carrier full official name result carrier ocn string operating company number of the carrier result carrier mcc string mobile country code result carrier mnc string mobile network code result device object device level information result device identifier object device identifier information result device identifier imei object imei related information result device identifier imei tenure object tenure of the imei result device identifier imei tenure mindays string minimum imei tenure result device identifier imei tenure maxdays string maximum imei tenure result scores object score related data for the device or account result scores phonetrust object phone trust score details result scores phonetrust value string numerical phone trust score result activitylist array list of activities related to the phone (sim, device, network, etc ) result activitylist\[] type string type of activity (e g , phone, sim, nav) result activitylist\[] lookbackdays number number of days the activity covers result activitylist\[] score number activity score reason string message describing overall result of the api call code string status code of the api response (e g , s001) sample error e601 internal server error { "result" {}, "reason" "internal server error", "code" "e601" } e001 invalid regex { "result" {}, "reason" "bad request \\"consentstatus\\" must be one of \[optedin, optedout, notcollected, unknown]", "code" "e001" } e001 empty required field { "result" {}, "reason" "bad request \\"phonenumber\\" is not allowed to be empty", "code" "e001" } e401 upstream failure { "result" {}, "reason" "upstream error", "code" "e401" } e001 invalid phone number { "result" {}, "reason" "bad request \\"phonenumber\\" entered is invalid", "code" "e001" } error response parameters parameter description result empty result object reason reason for error c ode error code from signzy error codes http status code error code description 400 e001 bad request 401 e1001 unauthorized access 403 e201 forbidden 409 e401 upstream error 429 e501 rate limit exceeded 500 e601 internal server error 503 e701 service unavailable 504 e801 timeout success codes http status code success code description 200 s001 request successful 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!