Skip to main content

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

China uses a single official data source. For a given entity, all company data is AI-extracted from a single PDF document: the Credit Information Report (信用信息报告) downloaded from the Credit China portal.

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 sole data source for company profiles, legal representatives, and all structured attributes.
Data is retrieved via automated portal access. Requests can take several minutes to complete due to portal complexity.

Company Identifiers

Query Identifiers

USCC Format Breakdown: The 18-character Unified Social Credit Code follows the GB 32100-2015 standard:
  • Position 1: Registration management department code (e.g., 9 = industrial and commercial, 1 = government, 5 = civil affairs, Y = other)
  • Position 2: Organization category code (e.g., 1 = enterprise legal person, 2 = non-enterprise legal person, 3 = foreign entity)
  • Positions 3-8: Administrative division code (6 digits, e.g., 110000 = Beijing)
  • Positions 9-17: Entity identification code (9 alphanumeric characters, derived from the former organization code)
  • Position 18: Check digit (calculated using weighted modular arithmetic)
Characters I, O, S, V, Z are excluded to avoid confusion. The system validates USCC format with the regex: ^(?=.*[A-Z])[159Y][1239]\d{6}[0-9A-Z]{10}$

Identifiers in API Response

Once you retrieve company data, the identifiers object contains:
The identifier key in the API response is Unified Social Credit Code (full English name), not an abbreviated key like uscc. This identifier is AI-extracted from the Credit Information Report and always corresponds to the query USCC.

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 can take 1-3 minutes due to portal latency.
USCC validation is strict. The system validates the USCC format before attempting a search. If the input does not match the expected pattern (starts with [159Y][1239], followed by 6 digits and 10 alphanumeric characters), the search returns empty results immediately without hitting the portal. Invalid identifiers like 123456789012345678 will return no results.

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.
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 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, each company has exactly one legal representative (法定代表人). This person is personally liable for certain company obligations. The legal representative is typically the Chairman, Executive Director, or General Manager as specified in the company’s articles of association. Both individuals and corporate entities can appear as legal representatives, though individuals are the norm. All role classifications are AI-inferred from the PDF text.

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

Shareholder data extraction is not yet implemented in the current China integration. The trade register extract (信用信息报告) may contain shareholder information, but the AI parser for shareholders has not been migrated to the Atlas request system.
Shareholder data is currently returned as an empty array for all Chinese companies. This is a known limitation pending migration of the shareholder parser to Atlas.

Planned Extraction

When implemented, shareholder data will be AI-extracted from the Credit Information Report PDF, which typically includes:

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)

Documents by Company Type

The Credit Information Report is the only document type currently available for Chinese companies. It is retrieved via automated portal access. The same document is used both as a standalone deliverable and as the source for AI-parsed company profile data.

Example API Responses

All examples use placeholder data. Query: POST /v2/company with { "id": "<USCC>", "countryCode": "CN", "dataPoints": ["company", "legalRepresentatives"] }
Note: Revoked companies have active: false and status 吊销 (Revoked). The standardized status is CLOSED. Shareholder data is not yet available.
Documents are returned when "dataPoints": ["availableDocuments"] is requested.

Data Source Priority & Routing

China uses a single data source for all entity types: the Credit China portal (creditchina.gov.cn). There is no priority chain or fallback mechanism.
Single-source model: All data comes 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, the request fails.Attribute-level source mapping: