--- title: Phone Insights Score - Advance slug: us-apis/phone-insights-score-advance description: Get valuable information on the Trust Score API, a powerful tool assessing phone number trustworthiness. Learn how to interpret the Trust Score, available response versions, and required parameters. Discover fields and data fields used in requests and res docTags: createdAt: 2023-01-31T12:44:28.000Z --- ## 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 1. Fintech & Lending Risk Assessment - Evaluate risk of identity fraud before approving loans or credit using phone-based risk indicators. 2. E-commerce Transaction Verification - Use phone trust score to flag high-risk users or transactions during checkout. 3. Fraud Prevention in Digital Wallets - Detect fraud or recently ported numbers before allowing sensitive actions like money transfers or password resets. 4. Customer Onboarding in Telecom & Utilities - Assess user legitimacy based on deactivation patterns and SIM activity before issuing services. 5. Authentication & Login Flows - Use score as an additional risk signal to trigger step-up authentication or challenge mechanisms. 6. Ride-Sharing, Gig, or Rental Platforms - Quickly assess the trust level of new users or drivers/renters through phone number intelligence. ### Sample cURL ::::Tabs :::Tab{title="Production"} ```curl curl --location 'https://api.signzy.us/api/v3/us-kyc/phone-insights-score-advanced' \ --header 'Content-Type: application/json' \ --header 'Authorization:' \ --data '{ { "phoneNumber": "", "consentStatus": "", "consentOptinType": "", "consentOptinMethod": "", "consentOptinDuration": "", "consentOptinId": "", "consentOptinTimestamp": "", "options": { "carrierInfo": "", "portingInfo": "", "deactInfo": "", "callHandlingInfo": "", "acctInfo": "", "simChangeInfo": "", "imeiChangeInfo": "", "simActivity": "", "phoneActivity": "", "navActivity": "", "acctChangeInfo": "", "phoneTrustScore": "" } }' ``` ::: :::Tab{title="Pre-Production"} ```curl curl --location 'https://api-preproduction.signzy.us/api/v3/us-kyc/phone-insights-score-advanced' \ --header 'Content-Type: application/json' \ --header 'Authorization:' \ --data '{ { "phoneNumber": "", "consentStatus": "", "consentOptinType": "", "consentOptinMethod": "", "consentOptinDuration": "", "consentOptinId": "", "consentOptinTimestamp": "", "options": { "carrierInfo": "", "portingInfo": "", "deactInfo": "", "callHandlingInfo": "", "acctInfo": "", "simChangeInfo": "", "imeiChangeInfo": "", "simActivity": "", "phoneActivity": "", "navActivity": "", "acctChangeInfo": "", "phoneTrustScore": "" } }' ``` ::: :::: ### 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 :::CodeblockTabs Response ```json { "result": { "dateTime": "", "trxId": "", "status": "", "errorList": [ { "message": "", "detailMessage": "", "info": "" }, { "message": "", "detailMessage": "", "info": "" } ], "mdn": "", "subscriber": { "identifier": { "sim": { "tenure": { "minDays": "", "maxDays": "" } } }, "callHandlingInfo": { "callForwarding": "" }, "nameTenure": { "minDays": "" } }, "account": { "acctTypeScore": "", "acctTenure": { "min": "" }, "mdnTenure": { "minDays": "" }, "serviceStatusTenure": { "minDays": "" }, "lineType": "", "serviceTypeScore": "", "serviceStatusScore": "", "primaryAcctHolderScore": "", "portingInfo": { "ported": "", "tenure": { "minDays": "" }, "lastCarrier": { "name": "", "originalName": "" } }, "deactInfo": { "lastDeactDate": "", "lastCarrierName": "", "lastDeactType": "" }, "smsCapable": "", "smsServiceProvider": "" }, "carrier": { "name": "", "originalName": "", "ocn": "", "mcc": "", "mnc": "" }, "device": { "identifier": { "imei": { "tenure": { "minDays": "", "maxDays": "" } } } }, "scores": { "phoneTrust": { "value": "" } }, "activityList": [ { "type": "", "lookbackDays": "", "score": "" } ] }, "reason": "", "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 :::CodeblockTabs E601 Internal Server Error ```json { "result": {}, "reason": "Internal Server Error", "code": "E601" } ``` E001 Invalid regex ```json { "result": {}, "reason": "Bad Request: \"consentStatus\" must be one of [optedIn, optedOut, notCollected, unknown]", "code": "E001" } ``` E001 Empty Required field ```json { "result": {}, "reason": "Bad Request: \"phoneNumber\" is not allowed to be empty", "code": "E001" } ``` E401 Upstream Failure ```json { "result": {}, "reason": "Upstream error", "code": "E401" } ``` E001 Invalid Phone number ```curl { "result": {}, "reason": "Bad Request: \"phoneNumber\" entered is invalid", "code": "E001" } ``` ::: ### Error Response Parameters | **Parameter** | **Description** | | ------------- | ---------------------- | | result | Empty result object | | reason | Reason for error | | code | 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. | :::hint{type="info"} ### 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 [help@signzy.com](#). 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! :::