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

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

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