POSTPublicpersonal-limit-high-consumption

Restricted Consumption Personnel Lookup

Query whether an individual is on the restricted high-consumption list based on name, ID number, and mobile number, returning verification results and related record lists, suitable for risk control review and background checks.

Usage Cost

20 coins/call

Try it online

Fire a real request right from your browser, no code required

Documentation

API Capabilities

The Restricted High-Consumption Personnel Query API allows enterprises to query whether an individual is listed on the restricted high-consumption (referred to as "restricted spending") personnel list by inputting their name, ID number, and mobile number. The API will return a clear verification result (e.g., whether they are on the list), along with the total number of related records and a detailed list. This API can provide auxiliary information for enterprise credit assessment, risk control, and background checks.

Request and Response

Request Parameters: The name (name), idcard_number (ID number), and mobile_number (mobile number) of the queried person must be provided simultaneously. Please ensure the input information is true, valid, and matching.
Return Results: In the returned data object, the result field describes the current status (e.g., "Not listed on the restricted consumption list"), total indicates the number of relevant records, and the list array contains specific restricted spending record details (if any).
Troubleshooting Failures: If the query fails or an error occurs, please check if the ID number format is valid and if the mobile number is a standard 11-digit number.

Use Cases

Integration Examples

Includes ready-to-use Shell, Python, Go, Java, and PHP examples for direct integration.

Request Example

{
  "name": "张三",
  "idcard_number": "110105199003078887",
  "mobile_number": "13800138000"
}

Response Example

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "result": "未列入限制消费名单",
    "total": 0,
    "list": []
  }
}

Request Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
name	string	张三
idcard_number	string	110105199003078887
mobile_number	string	13800138000

Response Fields

The fields below are derived from example JSON for integration reference only.

Path	Type	Sample
code	string	SUCCESS
message	string	success
data	object	{...}
data.result	string	未列入限制消费名单
data.total	number	0
data.list	array	[]

curl --request POST \ --url 'https://openapi.toolkk.com/v1/personal-limit-high-consumption' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "name": "张三",\n "idcard_number": "110105199003078887",\n "mobile_number": "13800138000"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/personal-limit-high-consumption" payload = { "name": "张三", "idcard_number": "110105199003078887", "mobile_number": "13800138000" } headers = { "Content-Type": "application/json", "X-API-Key": os.getenv("TOOLKK_API_KEY", "YOUR_API_KEY"), } response = requests.request("POST", url, headers=headers, json=payload, timeout=30) response.raise_for_status() print(response.json())

package main import ( "bytes" "fmt" "io" "net/http" ) func main() { endpoint := "https://openapi.toolkk.com/v1/personal-limit-high-consumption" payload := []byte("{\n \"name\": \"张三\",\n \"idcard_number\": \"110105199003078887\",\n \"mobile_number\": \"13800138000\"\n}") req, err := http.NewRequest("POST", endpoint, bytes.NewBuffer(payload)) if err != nil { panic(err) } req.Header.Set("Content-Type", "application/json") req.Header.Set("X-API-Key", "YOUR_API_KEY") resp, err := http.DefaultClient.Do(req) if err != nil { panic(err) } defer resp.Body.Close() body, err := io.ReadAll(resp.Body) if err != nil { panic(err) } fmt.Println(string(body)) }

import java.net.URI; import java.net.http.HttpClient; import java.net.http.HttpRequest; import java.net.http.HttpResponse; public class ToolkkExample { public static void main(String[] args) throws Exception { String payload = "{\n \"name\": \"张三\",\n \"idcard_number\": \"110105199003078887\",\n \"mobile_number\": \"13800138000\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/personal-limit-high-consumption")) .method("POST", HttpRequest.BodyPublishers.ofString(payload)) .header("Content-Type", "application/json") .header("X-API-Key", "YOUR_API_KEY") .build(); HttpResponse<String> response = HttpClient.newHttpClient() .send(request, HttpResponse.BodyHandlers.ofString()); System.out.println(response.body()); } }

<?php $endpoint = 'https://openapi.toolkk.com/v1/personal-limit-high-consumption'; $payload = "{\n \"name\": \"张三\",\n \"idcard_number\": \"110105199003078887\",\n \"mobile_number\": \"13800138000\"\n}"; $ch = curl_init($endpoint); curl_setopt_array($ch, [ CURLOPT_RETURNTRANSFER => true, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_HTTPHEADER => [ 'Content-Type: application/json', 'X-API-Key: YOUR_API_KEY', ], CURLOPT_POSTFIELDS => $payload, ]); $response = curl_exec($ch); if ($response === false) { throw new RuntimeException(curl_error($ch)); } curl_close($ch); echo $response;

Restricted Consumption Personnel Lookup

Try it online

Documentation

API Capabilities

Request and Response

Use Cases

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Usage Notes and Limitations

Shell Example

Python Example

Go Example

Java Example

PHP Example