Querying Enterprise Information via API
A RESTful API is available for retrieving comprehensive enterprise details, which is useful for features like online invoicing and auto-completing company information. Users can search by partial company names or credit codes to fetch complete records.
API Request and Example
HTTP GET Request
# Base URL structure
# The 'code' parameter is mandatory and must be obtained from the provider.
https://api.provider.com/enterprise/search?keyword=Chongqing Cola&code=YOUR_ACCESS_CODE
Sample Response
{
"status": 200,
"message": "success",
"results": [
{
"internalId": "1105",
"systemCreateTime": 1695260987000,
"matchMethod": "Company Name",
"registrationNumber": "500113014353471",
"establishmentDate": "2021-06-02",
"companyName": "Chongqing Cola Home Decoration Engineering Co., Ltd.",
"legalRepresentative": "Li Lunzhi",
"uniformCreditCode": "91500113MAABRA7D0H",
"dataSourceId": "58e62a6d-a6fa-482a-972d-84131629b2e4",
"matchedField": "Chongqing Cola Home Decoration Engineering Co., Ltd.",
"enterpriseCategory": "0"
}
]
}
Access and Usage
This is a paid service with a cost of 0.01 CNY per request. The service is stable and supports numerous clients. To obtain an access code (code parameter), contact the provider or use the designated mini-program.
API Specification
| # | Parameter | Type | Description |
|---|---|---|---|
| 1 | internalId | int | System-generated unique idetnifier |
| 2 | systemCreateTime | long | Timestamp of record creation in the system |
| 3 | matchMethod | String | Matching algorithm used (for internal use) |
| 4 | registrationNumber | String | Official bussiness registration number |
| 5 | establishmentDate | String | Date the company was established (YYYY-MM-DD) |
| 6 | companyName | String | Full legal name of the enterprise |
| 7 | legalRepresentative | String | Name of the legal representative |
| 8 | uniformCreditCode | String | Unified social credit code |
| 9 | dataSourceId | String | Identifier from the data provider (internal) |
| 10 | enterpriseCategory | String | Entity type: 0=Company, 4=Association, 5=Law Firm, 6=HK Company |
| 11 | matchedField | String | The field that matched the search query (internal) |