POSTPublicidcard-validate

Name and ID Number Verification

Verify if a user's provided name and ID number are authentic, valid, and matching. Quickly validate identity information accuracy by cross-referencing with authoritative data sources.

Documentation

Features

The Name and ID Verification API provides a fast and accurate way to verify the consistency between a user's name and ID number. The system cross-references the submitted identity information with authoritative Ministry of Public Security data sources in real time, returning verification results to ensure the authenticity and validity of the identity.

Use Cases

User Registration & Real-Name Authentication: Require real-name authentication during user registration on financial, social, and e-commerce platforms to ensure authentic user identities and prevent fake accounts.
Business Compliance & Risk Control: Suitable for business scenarios requiring identity verification, such as loan applications, contract signing, and account recovery. It helps mitigate business risks and meet compliance requirements.
Fraud Prevention: Verify user identity information during transactions or services to effectively identify and prevent identity theft and fraudulent activities.

Instructions

To call this API, you need to provide the name and idNumber parameters for verification. The API will return the verification result, indicating whether the information matches, along with a match status code. Please ensure the provided name and ID number are correctly formatted, or the verification may fail. We recommend carefully reading the API documentation regarding request parameters, response parameters, and error codes before integration.

Integration Examples

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

Request Example

{
  "name": "张三",
  "idCardNo": "110105199003078887"
}

Response Example

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "result": "一致",
    "desc": "姓名和身份证号一致",
    "sex": "男",
    "birthday": "19900307",
    "address": "北京市西城区"
  }
}

Request Fields

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

Path	Type	Sample
name	string	张三
idCardNo	string	110105199003078887

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.desc	string	姓名和身份证号一致
data.sex	string	男
data.birthday	string	19900307

curl --request POST \ --url 'https://openapi.toolkk.com/v1/idcard-validate' \ --header 'Content-Type: application/json' \ --header 'X-API-Key: YOUR_API_KEY' \ --data '{\n "name": "张三",\n "idCardNo": "110105199003078887"\n}'

import os import requests url = "https://openapi.toolkk.com/v1/idcard-validate" payload = { "name": "张三", "idCardNo": "110105199003078887" } 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/idcard-validate" payload := []byte("{\n \"name\": \"张三\",\n \"idCardNo\": \"110105199003078887\"\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 \"idCardNo\": \"110105199003078887\"\n}"; HttpRequest request = HttpRequest.newBuilder() .uri(URI.create("https://openapi.toolkk.com/v1/idcard-validate")) .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/idcard-validate'; $payload = "{\n \"name\": \"张三\",\n \"idCardNo\": \"110105199003078887\"\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;

Name and ID Number Verification

Documentation

Features

Use Cases

Instructions

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Shell Example

Python Example

Go Example

Java Example

PHP Example

Try it online