POSTPublicidcard-area-query

Chinese ID Card Location Lookup

Look up the location of an ID card number, including province and city. Supports fast verification and lookup of mainland China ID card numbers.

Documentation

Feature Introduction

This API provides a location lookup service for ID card numbers. Users simply input a valid mainland China ID card number, and the system will return the corresponding province and city information. Based on authoritative data sources, this service ensures accurate and real-time results, providing reliable data support for your business.

Application Scenarios

: Verify whether the ID card information provided by users matches their actual location during registration, transactions, or other sensitive operations to improve authentication accuracy.

Path	Type	Sample
idCardNo	string	110105199003078887

Path	Type	Sample
code	string	SUCCESS
message	string	success
data	object	{...}
data.province	string	北京市
data.city	string	北京市
data.district	string	西城区
data.sex	string	男

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

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

Chinese ID Card Location Lookup

Documentation

Feature Introduction

Application Scenarios

Integration Examples

Request Example

Response Example

Request Fields

Response Fields

Shell Example

Python Example

Go Example

Java Example

PHP Example

Try it online