> ## Documentation Index
> Fetch the complete documentation index at: https://docs.topograph.co/llms.txt
> Use this file to discover all available pages before exploring further.

# China

> Country-specific identifiers, data sources, and implementation details

## 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.

<Card title="China coverage, pricing, and sources" icon="arrow-up-right-from-square" href="https://topograph.co/pricing/cn">
  Open the current catalog for supported datapoints, documents, sources, identifiers, and availability.
</Card>

<Note>
  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.
</Note>

## Table of Contents

* [Data Sources](#data-sources)
* [Company Identifiers](#company-identifiers)
* [Search Capabilities](#search-capabilities)
* [Quirks & Gotchas](#quirks--gotchas)
* [Mappings](#mappings)
* [Data Availability](#data-availability)
* [Example API Responses](#example-api-responses)

## 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.

<Note>
  Data is retrieved via automated portal access. Requests can take several minutes to complete due to portal complexity.
</Note>

## Company Identifiers

### Query Identifiers

| Company Type     | Source       | Format                            | Example              | Notes                                 |
| ---------------- | ------------ | --------------------------------- | -------------------- | ------------------------------------- |
| **All entities** | Credit China | 18 alphanumeric characters (USCC) | `91110000710926094P` | Unified Social Credit Code (统一社会信用代码) |

<Tip>
  **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}$`
</Tip>

### Identifiers in API Response

Once you retrieve company data, the `identifiers` object contains:

| Identifier Type              | Format                     | Example              | Found In                         |
| ---------------------------- | -------------------------- | -------------------- | -------------------------------- |
| `Unified Social Credit Code` | 18 alphanumeric characters | `91110000710926094P` | All entities registered in China |

<Note>
  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.
</Note>

## Search Capabilities

| Search Type          | Pattern                    | Example              | Match Type | Expected Results                                                     |
| -------------------- | -------------------------- | -------------------- | ---------- | -------------------------------------------------------------------- |
| By USCC              | 18 alphanumeric characters | `9144030071526726XG` | Exact      | Exact match returned first (matchType: id); other results may follow |
| By Chinese name      | Chinese characters         | `腾讯`                 | Fuzzy      | Multiple results                                                     |
| By full Chinese name | Chinese characters         | `腾讯科技(深圳)有限公司`       | Exact      | Exact match returned first (matchType: id); other results may follow |

<Note>
  **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.
</Note>

<Warning>
  **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.
</Warning>

## Quirks & Gotchas

| Quirk                                        | Details                                                                                                                                                                                                                                |
| -------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **All data is AI-parsed from PDF**           | Unlike countries with structured APIs, all company data for China is extracted from a Credit Information Report PDF by AI. Data quality depends on PDF quality and AI parsing accuracy.                                                |
| **Processing time is high**                  | Company profile requests are asynchronous and can take **up to 7 minutes** per attempt due to portal latency.                                                                                                                          |
| **Single legal representative per company**  | Chinese Company Law mandates exactly **one legal representative** (法定代表人) per company. This differs from jurisdictions that allow multiple legal representatives.                                                                      |
| **Shareholders not yet available**           | Shareholder extraction has not been migrated to the Atlas request system. The API returns an empty shareholders array for all Chinese companies.                                                                                       |
| **No UBO data**                              | Ultimate Beneficial Owner information is not publicly available through the Credit China portal.                                                                                                                                       |
| **Business scope instead of activity codes** | China has a national classification system (GB/T 4754) but the Credit Information Report provides free-text business scope (经营范围) rather than numeric codes. NACE and ISIC codes are therefore **always AI-inferred**.                 |
| **No establishment data**                    | Branch or subsidiary information is not extracted from the current data source.                                                                                                                                                        |
| **USCC replaced 3 old identifiers in 2015**  | Before reforms in 2015, Chinese businesses needed separate IDs from SAIC (business permit), STA (tax ID), and AQSIQ (organization code). The USCC unified these into a single 18-character code. Legacy identifiers are not supported. |

## 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.

| Local Status | English Translation     | Standardized Status         | Notes                                     |
| ------------ | ----------------------- | --------------------------- | ----------------------------------------- |
| 存续           | Existing / In Operation | Active                      | Company is registered and operating       |
| 在业           | In Business             | Active                      | Company is actively conducting business   |
| 开业           | Open for Business       | Active                      | Company has commenced operations          |
| 正常           | Normal                  | Active                      | Normal operating status                   |
| 迁出           | Relocated Out           | Active                      | Company relocated to another jurisdiction |
| 吊销           | Revoked                 | Closed                      | Business license revoked by authorities   |
| 注销           | Deregistered            | Closed                      | Voluntarily deregistered                  |
| 撤销           | Cancelled               | Closed                      | Registration cancelled by authorities     |
| 停业           | Ceased Operations       | Closed                      | Company has ceased business operations    |
| 清算           | In Liquidation          | Under Insolvency Proceeding | Company is undergoing liquidation         |

<Note>
  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.
</Note>

### 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**.

<Note>
  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.
</Note>

#### Commercial Companies

| Chinese Name     | English Translation                | Standardized              | Notes                                             |
| ---------------- | ---------------------------------- | ------------------------- | ------------------------------------------------- |
| 有限责任公司           | Limited Liability Company          | Limited Liability Company | Most common form for SMEs                         |
| 股份有限公司           | Company Limited by Shares          | Corporation               | Joint stock companies, including listed companies |
| 有限责任公司(自然人投资或控股) | LLC (Natural Person Investment)    | Limited Liability Company | Invested/controlled by individuals                |
| 有限责任公司(法人独资)     | LLC (Sole Legal Person)            | Limited Liability Company | Wholly owned by a legal person                    |
| 有限责任公司(自然人独资)    | LLC (Sole Natural Person)          | Limited Liability Company | One-person LLC owned by an individual             |
| 有限责任公司(外商投资)     | LLC (Foreign Investment)           | Limited Liability Company | Foreign-invested enterprise (FIE)                 |
| 有限责任公司(中外合资)     | Sino-Foreign Joint Venture LLC     | Limited Liability Company | Chinese-foreign equity joint venture              |
| 有限责任公司(外商合资)     | Foreign Joint Venture LLC          | Limited Liability Company | Multiple foreign investors                        |
| 股份有限公司(上市)       | Listed Company Limited by Shares   | Corporation               | Publicly listed corporation                       |
| 股份有限公司(非上市)      | Unlisted Company Limited by Shares | Corporation               | Private joint stock company                       |

#### Sole Entrepreneurs

| Chinese Name | English Translation                            | Standardized        |
| ------------ | ---------------------------------------------- | ------------------- |
| 个体工商户        | Individual Industrial and Commercial Household | Sole Proprietorship |
| 个人独资企业       | Sole Proprietorship Enterprise                 | Sole Proprietorship |

#### Partnerships

| Chinese Name | English Translation         | Standardized        |
| ------------ | --------------------------- | ------------------- |
| 普通合伙企业       | General Partnership         | Partnership         |
| 有限合伙企业       | Limited Partnership         | Limited Partnership |
| 特殊普通合伙企业     | Special General Partnership | Partnership         |

#### Non-Profits & Social Organizations

| Chinese Name | English Translation         | Standardized           |
| ------------ | --------------------------- | ---------------------- |
| 民办非企业单位      | Private Non-Enterprise Unit | Nonprofit Organization |
| 社会团体         | Social Organization         | Nonprofit Organization |
| 基金会          | Foundation                  | Nonprofit Organization |

#### State-Owned & Public Entities

| Chinese Name | English Translation                          | Standardized            |
| ------------ | -------------------------------------------- | ----------------------- |
| 全民所有制        | State-Owned Enterprise (Wholly People-Owned) | Government-Owned Entity |
| 集体所有制        | Collectively-Owned Enterprise                | Government-Owned Entity |
| 国有独资公司       | State-Owned Sole Proprietorship Company      | Government-Owned Entity |

#### Foreign Entities

| Chinese Name          | English Translation                      | Standardized                    |
| --------------------- | ---------------------------------------- | ------------------------------- |
| 外国(地区)企业在中国境内从事生产经营活动 | Foreign Enterprise Operating in China    | Branch or Representative Office |
| 外国(地区)企业常驻代表机构        | Foreign Enterprise Representative Office | Branch or Representative Office |

### 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.

| Role (Chinese) | Role (English)        | Classification       | Notes                                                  |
| -------------- | --------------------- | -------------------- | ------------------------------------------------------ |
| 法定代表人          | Legal Representative  | Legal Representative | The primary legally authorized person; one per company |
| 董事长            | Chairman of the Board | Legal Representative | When serving as legal representative                   |
| 总经理            | General Manager       | Legal Representative | When serving as legal representative                   |
| 执行董事           | Executive Director    | Legal Representative | Common in smaller LLCs without a board                 |
| 负责人            | Person in Charge      | Legal Representative | Used for branches and representative offices           |

<Note>
  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.
</Note>

### 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.

<Warning>
  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.
</Warning>

#### Planned Extraction

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

| Field             | Description                              | Source                                 |
| ----------------- | ---------------------------------------- | -------------------------------------- |
| `name`            | Shareholder name (individual or company) | AI-extracted from PDF                  |
| `type`            | Individual or Company                    | AI-inferred from name                  |
| `sharePercentage` | Ownership percentage                     | AI-extracted from PDF (when available) |
| `shareCapital`    | Subscribed capital contribution          | AI-extracted from PDF (when available) |

### 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:

```
Business Scope (经营范围, free text) → AI → NACE Rev. 2 + ISIC Rev. 4
```

| Classification     | Source                              | AI Inferred?       |
| ------------------ | ----------------------------------- | ------------------ |
| **Business Scope** | Trade register extract (经营范围)       | No (official text) |
| **NACE**           | AI-derived from business scope text | Yes (always)       |
| **ISIC**           | AI-derived from business scope text | Yes (always)       |

<Note>
  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.
</Note>

## Data Availability

### Data Availability Matrix

| Data Type                  | Credit Information Report (AI-parsed) | Notes                                                                  |
| -------------------------- | ------------------------------------- | ---------------------------------------------------------------------- |
| Company Profile            | ✅ Async                               | Legal name, address, status, legal form, capital, activity description |
| Legal Representatives      | ✅ Async                               | AI-extracted from trade register extract PDF                           |
| Shareholders               | ❌ (Planned)                           | Parser not yet migrated to Atlas                                       |
| Ultimate Beneficial Owners | ❌                                     | Not publicly available in China                                        |
| Establishments             | ❌                                     | Not extracted from current data source                                 |
| Activity Codes             | ✅ Async                               | AI-inferred NACE/ISIC from business scope text                         |

**Legend:** ✅ Available | ❌ Not Available | Async = Asynchronous processing (up to 7 minutes)

### Documents by Company Type

| Document Type                          | API Category           | Format | Catalog item                     | Availability   | Notes                                          |
| -------------------------------------- | ---------------------- | ------ | -------------------------------- | -------------- | ---------------------------------------------- |
| **Credit Information Report** (信用信息报告) | `tradeRegisterExtract` | PDF    | `CHN_CERTIFIED_REGISTER_EXTRACT` | ✅ All entities | Official credit report from creditchina.gov.cn |

<Note>
  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.
</Note>

### Example API Responses

All examples use **placeholder data**. Query: `POST /v2/company` with `{ "id": "<USCC>", "countryCode": "CN", "dataPoints": ["company", "legalRepresentatives"] }`

<AccordionGroup>
  <Accordion title="Active Limited Liability Company">
    ```json theme={null}
    {
      "company": {
        "id": "91110000710926094P",
        "countryCode": "CN",
        "identifiers": {
          "Unified Social Credit Code": "91110000710926094P"
        },
        "legalName": "北京示例科技有限公司",
        "legalNameInEnglish": "Beijing Example Technology Co., Ltd.",
        "registrationDate": "2018-05-15",
        "activityDescription": "技术开发、技术咨询、技术服务；软件开发；销售自行开发的产品。",
        "status": {
          "localName": "存续",
          "active": true,
          "statusDetails": {
            "status": "ACTIVE"
          }
        },
        "legalForm": {
          "localName": "有限责任公司(自然人投资或控股)",
          "englishTranslation": "Limited Liability Company (Natural Person Investment)",
          "standardized": "Limited Liability Company",
          "iso20275Code": "8888"
        },
        "capital": {
          "amount": 10000000,
          "currency": "CNY"
        },
        "activities": {
          "NACE": [{ "code": "6201", "description": "Computer programming activities", "isAIInferred": true }],
          "ISIC": [{ "code": "6201", "description": "Computer programming activities", "isAIInferred": true }]
        },
        "legalAddress": {
          "addressLine1": "北京市海淀区中关村大街1号",
          "city": "Beijing",
          "countryCode": "CN"
        }
      },
      "legalRepresentatives": [
        {
          "type": "individual",
          "role": {
            "localName": "法定代表人",
            "englishTranslation": "Legal Representative",
            "standardized": "Legal Representative"
          },
          "individual": {
            "name": {
              "fullName": "张伟"
            }
          }
        }
      ],
      "shareholders": []
    }
    ```
  </Accordion>

  <Accordion title="Active Corporation (Stock Company)">
    ```json theme={null}
    {
      "company": {
        "id": "91310000XXXXXXXXX1",
        "countryCode": "CN",
        "identifiers": {
          "Unified Social Credit Code": "91310000XXXXXXXXX1"
        },
        "legalName": "上海示例制造股份有限公司",
        "legalNameInEnglish": "Shanghai Example Manufacturing Co., Ltd.",
        "registrationDate": "2005-08-22",
        "activityDescription": "金属材料的制造、加工和销售；钢铁冶炼。",
        "status": {
          "localName": "在业",
          "active": true,
          "statusDetails": {
            "status": "ACTIVE"
          }
        },
        "legalForm": {
          "localName": "股份有限公司(上市)",
          "englishTranslation": "Listed Company Limited by Shares",
          "standardized": "Corporation"
        },
        "capital": {
          "amount": 500000000,
          "currency": "CNY"
        },
        "activities": {
          "NACE": [{ "code": "2410", "description": "Manufacture of basic iron and steel", "isAIInferred": true }],
          "ISIC": [{ "code": "2410", "description": "Manufacture of basic iron and steel", "isAIInferred": true }]
        },
        "legalAddress": {
          "addressLine1": "上海市宝山区工业路500号",
          "city": "Shanghai",
          "countryCode": "CN"
        }
      },
      "legalRepresentatives": [
        {
          "type": "individual",
          "role": {
            "localName": "董事长",
            "englishTranslation": "Chairman of the Board",
            "standardized": "Chairman"
          },
          "individual": {
            "name": {
              "fullName": "王强"
            }
          }
        }
      ],
      "shareholders": []
    }
    ```
  </Accordion>

  <Accordion title="Revoked (Closed) Company">
    ```json theme={null}
    {
      "company": {
        "id": "91310000MA1FL8XQ30",
        "countryCode": "CN",
        "identifiers": {
          "Unified Social Credit Code": "91310000MA1FL8XQ30"
        },
        "legalName": "上海旧商贸有限公司",
        "registrationDate": "2010-03-20",
        "activityDescription": "日用百货、服装鞋帽的销售。",
        "status": {
          "localName": "吊销",
          "active": false,
          "statusDetails": {
            "status": "CLOSED"
          }
        },
        "legalForm": {
          "localName": "有限责任公司",
          "englishTranslation": "Limited Liability Company",
          "standardized": "Limited Liability Company"
        },
        "legalAddress": {
          "addressLine1": "上海市浦东新区张江路100号",
          "city": "Shanghai",
          "countryCode": "CN"
        }
      },
      "legalRepresentatives": [
        {
          "type": "individual",
          "role": {
            "localName": "法定代表人",
            "englishTranslation": "Legal Representative",
            "standardized": "Legal Representative"
          },
          "individual": {
            "name": {
              "fullName": "李明"
            }
          }
        }
      ],
      "shareholders": []
    }
    ```

    **Note:** Revoked companies have `active: false` and status `吊销` (Revoked). The standardized status is `CLOSED`. Shareholder data is not yet available.
  </Accordion>

  <Accordion title="Available Documents">
    Documents are returned when `"dataPoints": ["availableDocuments"]` is requested.

    | API Category           | Document                               | Notes        |
    | ---------------------- | -------------------------------------- | ------------ |
    | `tradeRegisterExtract` | Credit Information Report (信用信息报告) PDF | All entities |

    ```json theme={null}
    {
      "documents": {
        "tradeRegisterExtract": {
          "id": "doc_cn_xxxxxxxx",
          "name": "信用信息报告 (Credit Information Report)",
          "format": "PDF",
          "url": "https://..."
        }
      }
    }
    ```
  </Accordion>
</AccordionGroup>

## 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.

<Note>
  **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:**

  | Attribute                        | Source                        | AI Inferred? |
  | -------------------------------- | ----------------------------- | ------------ |
  | Company name (Chinese + English) | Credit Information Report PDF | Yes          |
  | Legal form                       | Credit Information Report PDF | Yes          |
  | Status                           | Credit Information Report PDF | Yes          |
  | Registered address               | Credit Information Report PDF | Yes          |
  | Registration date                | Credit Information Report PDF | Yes          |
  | Share capital                    | Credit Information Report PDF | Yes          |
  | Business scope (活动描述)            | Credit Information Report PDF | Yes          |
  | Activity codes (NACE/ISIC)       | Derived from business scope   | Yes (always) |
  | Legal representative             | Credit Information Report PDF | Yes          |
  | Shareholders                     | Not extracted                 | N/A          |
  | UBOs                             | Not available                 | N/A          |
  | Establishments                   | Not extracted                 | N/A          |
</Note>