Real-time access to accurate business registry data is critical for enterprise application development. This API solution allows for the rapid retrieval of comprehensive corporate registration details—including the Unified Social Credit Code, registered capital, legal representative, business scope, industry classification, and registering authority—using the company name, registration number, or credit code as the query parameter.
API Specifications
Endpoint: https://api.service-provider.com/v1/enterprise/registry
Method: GET
Request Parameters
| Parameter | Required | Type | Description |
|---|---|---|---|
access_token |
Yes | String | Authorization credential obtained via the designated platform. Keep this token secure. |
entity_query |
Yes | String | The full enterprise name, registration number, or Unified Social Credit Code. |
Response Structure
| Parameter | Type | Description |
|---|---|---|
status |
Integer | HTTP status code; 200 indicates success. |
message |
String | Response message, typically "success" on completion. |
data |
Object | Container for the enterprise details. |
data.econKind |
String | Enterprise type (e.g., LLC). |
data.registCapi |
String | Registered capital (amount and currency). |
data.operName |
String | Name of the legal representative. |
data.address |
String | Registered business address. |
data.scope |
String | Business scope and activities. |
data.startDate |
String | Date of establishment. |
data.termStart |
String | Business operation start date. |
data.termEnd |
String | Business operation end date. |
data.belongOrg |
String | Regulating authority (AIC). |
data.creditNo |
String | Unified Social Credit Code. |
Implementation Example (Python)
import requests
def fetch_enterprise_data(auth_key, search_term):
"""
Retrieves enterprise registry data via the API.
"""
base_endpoint = "https://api.service-provider.com/v1/enterprise/registry"
request_params = {
"access_token": auth_key,
"entity_query": search_term
}
try:
api_response = requests.get(base_endpoint, params=request_params)
api_response.raise_for_status()
return api_response.()
except requests.exceptions.RequestException as err:
print(f"API Request Failed: {err}")
return None
# Configuration
API_SECRET = "YOUR_ACCESS_TOKEN"
TARGET_ENTITY = "Chongqing Little Cola Network Media Co., Ltd."
# Execution
result = fetch_enterprise_data(API_SECRET, TARGET_ENTITY)
if result and result.get("code") == 200:
details = result["data"]
print(f"Company: {details.get('name')}")
print(f"Representative: {details.get('operName')}")
print(f"Capital: {details.get('registCapi')}")
print(f"Credit Code: {details.get('creditNo')}")
else:
print("Query unsuccessful.")
Usage Guidelines
Pricing: 0.2 RMB per request.
Performance: Since there is a cost per call, it is highly recommended to implement a caching mechanism to store previously retrieved data and minimize redundant API usage.
Compliance: Ensure that all retrieved data is used in accordance with relevant privacy and commercial laws.
To maximize query efficiency, consider pairing this endpoint with a fuzzy search API for preliminary lookups.