Start here
This guide contains public integration notes for China. Use it for identifier formats, search behavior, and country-specific caveats. The live source of truth for coverage, pricing, data sources, documents, legal forms, roles, and status values is the pricing page.China coverage, pricing, and sources
Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
Country details below are preserved as integration notes. If a table or example conflicts with the live pricing page, use the pricing page as the source of truth and contact support.
Table of Contents
- Data Sources
- Company Identifiers
- Search Capabilities
- Quirks & Gotchas
- Mappings
- Data Availability
- Example API Responses
Data Sources
For a given entity, company data and legal representatives are AI-extracted from a single PDF document: the Credit Information Report (信用信息报告) downloaded from the Credit China portal. Shareholders and ultimate beneficial owners are not published by Credit China. They are obtained separately from commercial reports supplied through a local partner, as manually fulfilled products.All entity types
- Credit China (信用中国). Official national credit information platform operated by the National Development and Reform Commission (NDRC) in collaboration with the People’s Bank of China. The portal (
creditchina.gov.cn) provides Credit Information Reports (信用信息报告) in PDF format. This is the data source for company profiles, legal representatives, and all structured company attributes. - Local partner (shareholders and beneficial owners). A commercial shareholder report and a commercial beneficial owner report are retrieved by our local partner from a Chinese business-data platform that compiles national business register filings. Ownership data is AI-extracted from these reports. They are not official register certificates. Delivery typically takes a few business days.
Data is retrieved via automated portal access. Requests can take several minutes to complete due to portal complexity.
Company Identifiers
Query Identifiers
Identifiers in API Response
Once you retrieve company data, theidentifiers object contains:
The identifier key in the API response is
uscc (Unified Social Credit Code). Its value always corresponds to the query USCC.Legal Entity Identifier (LEI)
GLEIF is the supplementary data source for this identifier.company.identifiers.lei is optional. It is returned when the Unified Social Credit Code (USCC) matches a registration or validation reference in GLEIF and identifies a single LEI.
The LEI has 20 uppercase letters and digits, ending in two digits. Coverage varies by entity; a missing LEI does not establish that the company has none.
Lapsed or retired LEIs can still be returned. Annulled LEIs are excluded, so the presence of this identifier does not establish current LEI registration status.
Search Capabilities
Search uses live portal access. Both identifier and name searches query the Credit China portal in real time. There is no pre-built search index. Search is slower than in most countries and typically takes under a minute.
Active companies only
Search can return companies that are no longer active, but their status is not known at search time, soactiveOnly=true has no effect. Check company.status on the company profile. Search results carry no company status, so the active-only filter has no effect. Check the status on the company profile.
Quirks & Gotchas
Mappings
Company Status
Company status is AI-extracted from the Credit Information Report (信用信息报告) PDF. The AI parser reads the status field from the document and maps it to a standardized status.Status is AI-extracted from the trade register extract PDF. The local Chinese status term is preserved verbatim and mapped to a standardized status. The
isAIInferred flag on status reflects this AI extraction.Legal Forms
China uses a variety of legal entity forms. Since company data is AI-extracted from the Credit Information Report PDF, the legal form is parsed from the document text. The mapping to standardized forms and ISO 20275 (ELF) codes is AI-enriched.Legal form standardization and ISO 20275 assignment are AI-enriched. The local Chinese legal form name is preserved verbatim from the trade register extract. Because legal forms are AI-inferred, exact mappings may evolve.
Commercial Companies
Sole Entrepreneurs
Partnerships
Non-Profits & Social Organizations
State-Owned & Public Entities
Foreign Entities
Legal Representatives
Legal representatives are AI-extracted from the Credit Information Report (信用信息报告) PDF. In China, the legal representative (法定代表人) is a single individual who has binding authority on behalf of the company under Chinese law.Under Chinese Company Law, a company designates a director or manager who executes its affairs as its legal representative (法定代表人). The title does not identify which underlying management office that person holds. Known representative headings use the published role list and return
Authorized Signatory; extraction of the person from the report still uses AI. Combined headings retain the alternatives printed in the source rather than assigning every listed office to that person.Other Key Persons
Not applicable. The Credit Information Report does not include structured data for supervisory board members, auditors, or other key persons beyond the legal representative. Board member or senior executive data is not currently extracted.Shareholders
The Credit Information Report does not include ownership. Requestshareholders in verification mode: this is a separate, manually fulfilled product. Our local partner retrieves the full shareholder list (股东信息) as a commercial shareholder report, and shareholders are AI-extracted from it. Delivery typically takes a few business days.
Shareholders are billed separately from company data. The shareholder report itself is also available as the
certifiedTradeRegisterExtract document. Verify AI-extracted ownership against the report before relying on it for compliance.Ultimate Beneficial Owners
Ultimate beneficial owners (受益所有人 / 最终受益人) follow the same model: a commercial beneficial owner report retrieved through our local partner, AI-extracted, and billed separately. This is not an official beneficial-ownership register certificate. RequestultimateBeneficialOwners in verification mode for structured data, or order ultimateBeneficialOwnersCertificate from availableDocuments for the source PDF. Delivery is asynchronous and typically takes a few business days. Follow the existing request through webhooks or polling; do not submit repeated orders while it is pending. If the report cannot be obtained, the request reports an error rather than a successful empty result.
Activity Code Mapping
China does not use a single standardized industry classification code in the Credit Information Report. Activity information is extracted as a free-text description from the business scope (经营范围) field, then mapped via AI:China has a national classification system (GB/T 4754, 国民经济行业分类) but the Credit Information Report typically provides a free-text business scope rather than a numeric code. Both NACE and ISIC codes are therefore always AI-inferred for Chinese companies. Every activity item includes an
isAIInferred: true flag.Data Availability
Data Availability Matrix
Legend: ✅ Available | ❌ Not Available | Async = Asynchronous processing (up to 7 minutes) | Manual = fulfilled by a local partner, typically a few business days
Documents by Company Type
The Credit Information Report is used both as a standalone deliverable and as the source for AI-parsed company profile data. The shareholder report and the beneficial owner report are separate commercial documents, not official register certificates, and are the sources for the
shareholders and ultimateBeneficialOwners datapoints. Ordering the document or the datapoint triggers the same partner request.Example API Responses
All examples use placeholder data. Query:POST /v2/company with { "id": "<USCC>", "countryCode": "CN", "dataPoints": ["company", "legalRepresentatives"] }
Active Limited Liability Company
Active Limited Liability Company
Active Corporation (Stock Company)
Active Corporation (Stock Company)
Revoked (Closed) Company
Revoked (Closed) Company
active: false and status 吊销 (Revoked). The standardized status is CLOSED. Shareholders are not part of this request; request them separately in verification mode.Available Documents
Available Documents
The table lists supported documents; the example shows a retrieved Credit Information Report. Available document IDs are returned when
"dataPoints": ["availableDocuments"] is requested.Data Source Priority & Routing
China uses the Credit China portal (creditchina.gov.cn) for company data and legal representatives, and commercial reports obtained through our local partner for shareholders and ultimate beneficial owners. There is no priority chain or fallback mechanism.
Single source per datapoint: Company data and legal representatives come from the Credit Information Report (信用信息报告) PDF downloaded from Credit China. There is no cross-source merging or fallback. If the Credit China portal is unavailable, those datapoints fail; partner reports do not replace the profile source.Attribute-level source mapping: