invoice-title-list
Company Invoicing Information Lookup
Look up company invoicing information, including company name, tax ID, address, phone number, bank name, and bank account details. This facilitates invoice management and financial reconciliation.
Usage Cost
20 coins/call
Quick Start
Use a unified response envelope and call directly from your backend.
https://openapi.toolkk.com/v1/invoice-title-listcURL Example
curl --request POST \
--url 'https://openapi.toolkk.com/v1/invoice-title-list' \
--header 'Content-Type: application/json' \
--header 'X-API-Key: YOUR_API_KEY' \
--data '{\n "enterpriseName": "阿里巴巴(中国)有限公司",\n "pageNo": 1,\n "pageSize": 10\n}'Python Example
import os
import requests
url = "https://openapi.toolkk.com/v1/invoice-title-list"
payload = {
"enterpriseName": "阿里巴巴(中国)有限公司",
"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/invoice-title-list"
payload := []byte("{\n \"enterpriseName\": \"阿里巴巴(中国)有限公司\",\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 \"enterpriseName\": \"阿里巴巴(中国)有限公司\",\n \"pageNo\": 1,\n \"pageSize\": 10\n}";
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create("https://openapi.toolkk.com/v1/invoice-title-list"))
.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/invoice-title-list';
$payload = "{\n \"enterpriseName\": \"阿里巴巴(中国)有限公司\",\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": [
{
"name": "阿里巴巴(中国)有限公司",
"creditNo": "91330100799655058B",
"address": "杭州市余杭区文一西路969号",
"phone": "0571-85022088",
"bank": "招商银行",
"account": "571900201510201"
}
]
}
}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 |
|---|---|---|---|---|
| enterpriseName | string | Unspecified | Unspecified | 阿里巴巴(中国)有限公司 |
| pageNo | number | Unspecified | Unspecified | 1 |
| pageSize | number | Unspecified | Unspecified | 10 |
Request Example
{
"enterpriseName": "阿里巴巴(中国)有限公司",
"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 | [{"name":"阿里巴巴(中国)有限公司","creditNo":"91330100799655058B","address":"杭州市余杭区文一西路969号","phone":"0571-85022088","bank":"招商银行","account":"571900201510201"}] |
| data.list[] | object | Unspecified | Unspecified | {...} |
Response Example
{
"code": "SUCCESS",
"message": "success",
"data": {
"total": 1,
"list": [
{
"name": "阿里巴巴(中国)有限公司",
"creditNo": "91330100799655058B",
"address": "杭州市余杭区文一西路969号",
"phone": "0571-85022088",
"bank": "招商银行",
"account": "571900201510201"
}
]
}
}$.code == 200 API overview
Capabilities, use cases, limitations, and frequently asked questions.
Feature Overview
This API provides comprehensive lookup services for company invoicing information. Users can quickly retrieve complete billing details of target companies using unique identifiers like the company name or Unified Social Credit Code. Returned data includes, but is not limited to, the full company name, taxpayer identification number (TIN), registered address, contact phone number, bank name, and bank account number. This service is designed to streamline the information verification workflow for financial personnel when issuing and receiving invoices, thereby improving operational efficiency and data accuracy.
Use Cases
- Financial Reconciliation: Before issuing invoices, suppliers or customers can use this API to verify the payee's or payer's billing information. This ensures invoice accuracy and prevents voided or returned invoices due to incorrect details.
- E-commerce Platforms: When processing B2B orders, e-commerce platforms can automatically look up and auto-fill invoicing information, enhancing user experience and reducing manual intervention.
- ERP System Integration: Internal enterprise systems such as ERP and OA can integrate this API to automate the management and querying of invoicing details, boosting internal operational efficiency.
- Financial Services: Banks or other financial institutions can use this to verify corporate identity and financial qualifications when serving business clients.
- Tax Compliance: Helps companies ensure their invoicing practices comply with tax regulations, mitigating tax-related risks.