POSTPublicenterprise-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.

Documentation

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.

Integration Examples

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

Request Example

{
  "keyword": "阿里巴巴(中国)有限公司",
  "pageNo": 1,
  "pageSize": 10
}

Response Example

{
  "code": "SUCCESS",
  "message": "success",
  "data": {
    "total": 1,
    "list": [
      {
        "enterpriseName": "阿里巴巴(中国)有限公司",
        "creditNo": "91330100799655058B",
        "taxpayerType": "一般纳税人"
      }
    ]
  }
}

Request Fields

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

Path	Type	Sample
keyword	string	阿里巴巴(中国)有限公司
pageNo	number	1
pageSize	number	10

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.total	number	1
data.list	array	{"enterpriseName":"阿里巴巴(中国)有限公司","creditNo":"91330100799655058B","taxpayerType":"一般纳税人"}

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}'

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())

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)) }

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 $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;

Corporate Taxpayer Information 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