queryTagAndInfo

POST/prism/external/queryTagAndInfo-20%$0.1 USDT/call$0.08 USDT/call

Free billing instructions: No billing will be charged in case of abnormalities
Billing instructions for empty value: The interface is limited to 10 free empty value times per day
Empty value definition: The server query result is empty and no data was found

query citizen tag and basic info by CURP/email/phone

These examples use complete synthetic data. Use your own authorized input in Online Test to see the actual API response.

Start using this endpoint

  1. Create an account, or use your existing one.
  2. Copy your API token from Account → Security.
  3. Enter your token and your own authorized input in Online Test. Masked examples are format hints and must be replaced.

Online tests are subject to your account’s test quota and the gateway rules. For production calls, check the endpoint price and your available balance before sending. Open balance and recharge

Header Parameters

NameTypeRequiredDescription
X-Api-TokenstringRequiredYour platform API token

Parameters

NameInTypeRequiredExampleDescription
hello-agentquerystringRequired-agent

Request Body Example

{
  "secretKey": "fb4db743004087af5f63eb98568d284f415df64c9e9ac504770c20dc0845bca1",
  "userName": "SAMPLE USER",
  "eventCode": "query_tag_info",
  "keyword": "TEST900101HDFABC01"
}

Response 200JSON

{
  "code": 0,
  "msg": "OK",
  "data": {
    "userInfo": {
      "TEST900101HDFABC01": {
        "ext": {
          "risk_accept_score": "45.416",
          "job_stable_level": "28",
          "credit_level": "1",
          "risk_score_3_0": "57.049",
          "risk_score_3_1": "39.386",
          "repay_level": "3",
          "risk_score_1": "65.353",
          "salary_level": "27.847",
          "apply_loan_level": "7",
          "risk_score_2": "21.972",
          "status_level": "3"
        }
      }
    },
    "tag": {
      "TEST900101HDFABC01": [
        {
          "code": "is_whatsapp"
        },
        {
          "code": "is_advanced_contact"
        },
        {
          "code": "is_night_applicant_old"
        },
        {
          "code": "is_facebook"
        },
        {
          "code": "is_weekend_applicant_new"
        },
        {
          "code": "is_stable_job"
        },
        {
          "code": "is_overdue_30d_order"
        },
        {
          "code": "is_high_salary"
        },
        {
          "code": "is_weekend_applicant_old"
        },
        {
          "code": "is_rejected_applicant"
        }
      ]
    }
  }
}

Response Fields

NameTypeMeaningExampleDescription
status_levelstringIdentity risk level4Built from education background, social security payment, child-related status, and related signals. Higher values indicate higher risk.
salary_levelstringSalary level11Built from daily wage in social security records, salary in cash-loan records, and related signals. Higher values indicate lower risk.
job_stable_levelstringJob stability level27Built from working days, number of employers paying social security, residence type, and related signals. Higher values indicate lower risk.
repay_levelstringRepayment capability level2Built from bank level, bank deposits, number of registered financial institutions, and related signals. Higher values indicate lower risk.
credit_levelstringCredit level0.514Built from historical repayment rate, repayment amount, and repayment order count over the past 1 to 3 years. Higher values indicate lower risk.
apply_loan_levelstringLoan application level3Built from registered cash-loan platform count, maximum application frequency, disbursement count, repeat borrowing count, and related signals over the past 1 to 3 years. Higher values indicate higher risk.
risk_accept_scorestringRisk acceptance score20.399Built from registered cash-loan platform count, interest rates, repayment periods, application amounts, and related signals over the past 1 to 3 years. Higher values indicate a more subprime user segment and higher risk acceptance.
risk_score_1stringUser risk score V173.085Assesses post-loan behavior for single-period and short-term 7-day products. Higher values indicate higher risk. Model base: GBDT + LR.
risk_score_2stringUser risk score V227.314Assesses post-loan behavior for installment and medium-term 14 to 30 day products. Higher values indicate higher risk. Model base: GBDT + LR.
risk_score_3_0stringUser risk score V3, segment 058.917Assesses post-loan behavior for installment and medium-to-long-term products over 30 days. Higher values indicate higher risk. Model base: GBDT + LR.
risk_score_3_1stringUser risk score V3, segment 150.396Assesses post-loan behavior for installment and medium-to-long-term products over 30 days. Higher values indicate higher risk. Model base: GBDT + LR.

Data source

The upstream holder for this endpoint has not been confirmed yet. Do not rely on it for compliance-sensitive decisions until it is.

Rate limits & free allowance

Requests per second
10
Free empty results per day
10

Calls that return no matching record are not charged, up to this many per day. Beyond it, an empty result is billed at the unit price.

Balance is consumed at the time of the call. When it does not cover the call, the gateway returns 402 and the call is not made.

Error codes

Status codes observed in production, with how to handle each. Codes not listed here have not occurred.

CodeWhat it means and what to do
200Request reached the upstream source and a response was returned. This includes “no record found”, so check the payload, not just the code.
402Prepaid balance did not cover the call. The call was not made and nothing was charged. Top up and retry.
504Upstream source did not answer in time. Retry later; this is the normal failure mode for slow registries.
404Route does not exist, or the endpoint is no longer published.
401Missing or invalid API token.

Conditions of use

This endpoint returns personal data about an identifiable individual held by a national registry or institution. You must have a lawful basis for each identifier you query, must not enumerate identifier ranges, and must not use a result as the sole basis for a decision that adversely affects someone.