enterprise-general-taxpayer-query
Corporate Taxpayer Information Lookup
Query detailed general taxpayer information for businesses, including registration, operating status, and tax registration details. This helps users fully understand a target company's tax profile and operational compliance.
Usage Cost
20 coins/call
Quick Start
Use a unified response envelope and call directly from your backend.
https://openapi.toolkk.com/v1/enterprise-general-taxpayer-querycURL Example
curl --request POST \
--url 'https://openapi.toolkk.com/v1/enterprise-general-taxpayer-query' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "keyword": "阿里巴巴(中国)有限公司",\n "pageNo": 1,\n "pageSize": 10\n}'Python Example
import os
import requests
url = "https://openapi.toolkk.com/v1/enterprise-general-taxpayer-query"
payload = {
"keyword": "阿里巴巴(中国)有限公司",
"pageNo": 1,
"pageSize": 10
}
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())Go Example
package main
import (
"bytes"
"fmt"
"io"
"net/http"
)
func main() {
endpoint := "https://openapi.toolkk.com/v1/enterprise-general-taxpayer-query"
payload := []byte("{\n \"keyword\": \"阿里巴巴(中国)有限公司\",\n \"pageNo\": 1,\n \"pageSize\": 10\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))
}Java Example
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 \"keyword\": \"阿里巴巴(中国)有限公司\",\n \"pageNo\": 1,\n \"pageSize\": 10\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/enterprise-general-taxpayer-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 Example
<?php
$endpoint = 'https://openapi.toolkk.com/v1/enterprise-general-taxpayer-query';
$payload = "{\n \"keyword\": \"阿里巴巴(中国)有限公司\",\n \"pageNo\": 1,\n \"pageSize\": 10\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;Response Example
{
"code": "SUCCESS",
"message": "success",
"data": {
"total": 1,
"list": [
{
"enterpriseName": "阿里巴巴(中国)有限公司",
"creditNo": "91330100799655058B",
"taxpayerType": "一般纳税人"
}
]
}
}Examples illustrate the response structure. Actual results depend on the API response.
- Authentication
- Send X-API-Key in request headers
- Rate limit
- 600 req/min
- Timeout
- 5000 ms
Send your API Key in the X-API-Key header from your backend.
Check both HTTP status and business fields before treating a call as successful.
Use retries and backoff together with rate limits in high-frequency scenarios.
Request Fields
Send requests from your server with the key in the X-API-Key header.
Request Fields
The fields below are derived from example JSON for integration reference only.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| keyword | string | Unspecified | Unspecified | 阿里巴巴(中国)有限公司 |
| pageNo | number | Unspecified | Unspecified | 1 |
| pageSize | number | Unspecified | Unspecified | 10 |
Request Example
{
"keyword": "阿里巴巴(中国)有限公司",
"pageNo": 1,
"pageSize": 10
}- Authentication
- Send X-API-Key in request headers
- Rate limit
- 600 req/min
- Timeout
- 5000 ms
Response Fields
Examples illustrate the response structure. Actual results depend on the API response.
Response Fields
The fields below are derived from example JSON for integration reference only.
| Path | Type | Required | Description | Sample |
|---|---|---|---|---|
| code | string | Unspecified | Unspecified | SUCCESS |
| message | string | Unspecified | Unspecified | success |
| data | object | Unspecified | Unspecified | {...} |
| data.total | number | Unspecified | Unspecified | 1 |
| data.list | array | Unspecified | Unspecified | [{"enterpriseName":"阿里巴巴(中国)有限公司","creditNo":"91330100799655058B","taxpayerType":"一般纳税人"}] |
| data.list[] | object | Unspecified | Unspecified | {...} |
Response Example
{
"code": "SUCCESS",
"message": "success",
"data": {
"total": 1,
"list": [
{
"enterpriseName": "阿里巴巴(中国)有限公司",
"creditNo": "91330100799655058B",
"taxpayerType": "一般纳税人"
}
]
}
}$.code == 200 API overview
Capabilities, use cases, limitations, and frequently asked questions.
Feature Introduction
This API provides detailed lookup services for general corporate taxpayers. Users can use the company name or Unified Social Credit Code as search criteria to obtain comprehensive tax data for a target company. The returned data covers key details such as the company's basic registration information, current operating status, detailed business scope, tax registration status, taxpayer qualification type, and related tax credit ratings. This service is designed to help users gain a deep understanding of a company's tax profile and operational compliance.
Application Scenarios
- Corporate Credit Assessment: Financial institutions can use this API to verify a company's tax qualifications and operating status prior to loan approval, business partnerships, or investment decisions, effectively assessing potential risks.
- Supplier/Customer Background Checks: When selecting partners (suppliers, customers, etc.), companies can quickly verify their tax compliance and historical credit to ensure transaction security and stability.
- Risk Monitoring: Continuously monitor changes in the tax status of affiliated companies to detect potential tax risks or operational anomalies in a timely manner.
- Market Analysis and Research: Collect tax data for companies in specific industries or regions for macroeconomic analysis, market trend insights, or competitor research.