# China

China eKYB validates the legitimacy of Chinese businesses by checking their tax ID, business name, address, and UBOs against Chinese government sources of truth.

China eKYB supports input in Chinese, English, and Pinyin.

Directors are not currently supported for China. 

## Source

| Country | Source                              | Description                                                                            |
| ------- | ----------------------------------- | -------------------------------------------------------------------------------------- |
| China   | Chinese government sources of truth | Verifies submitted business details against records maintained in Chinese registries.  |

## Direct API approach

For general integration notes and shared response semantics, see the [eKYB API Reference](https://developer.incode.com/docs/ekyb-api-reference).

### Request parameters

| Parameter      | Required  | Description                                                                                                |
| -------------- | --------- | ---------------------------------------------------------------------------------------------------------- |
| `plugins`      | Mandatory | Array. Must be `["ekyb"]`.                                                                                 |
| `businessName` | Mandatory | String. Name of the business.                                                                              |
| `country`      | Mandatory | String. Two-letter Alpha-2 country code. Must be `CN`.                                                     |
| `taxId`        | Mandatory | String. Unified Social Credit Code, 18 characters.                                                         |
| `addressLine2` | Optional  | String. Full business address including house number, street, city, state, and postal code.                |
| `uboNames`     | Optional  | Array. Full legal names of Unique Beneficial Owners to check against records associated with the business. |

### Sample request

```json
{
  "plugins": ["ekyb"],
  "businessName": "SHANGHAI JINLONG TECHNOLOGY CO., LTD.",
  "addressLine2": "Pudong New Area, Zhangyang Road 88, Shanghai 200120",
  "country": "CN",
  "taxId": "91310000MA1K123456",
  "uboNames": ["Li Wei", "Zhang Mei"]
}
```

### Sample response

```json
{
  "kyb": [
    { "key": "name", "sub_label": "Verified" },
    { "key": "tin", "sub_label": "Verified" },
    { "key": "address_verification", "sub_label": "Verified" },
    { "key": "registrationStatus", "sub_label": "Active" },
    {
      "key": "entityType",
      "entityType": { "entityType": "Limited Liability Company (Sole Proprietorship by a Natural Person)" }
    },
    { "key": "ubo_name_match", "sub_label": "Verified", "uboName_input": "Li Wei" },
    { "key": "ubo_name_match", "sub_label": "Unverified", "uboName_input": "Zhang Mei" }
  ]
}
```

### Response fields

| Key                    | Status                                        | Description                                                                                                        |
| ---------------------- | --------------------------------------------- | ------------------------------------------------------------------------------------------------------------------ |
| `name`                 | `Verified`, `Approximate Match`, `Unverified` | Submitted business name against the business name associated with the tax ID.                                      |
| `tin`                  | `Verified`, `Unverified`                      | Submitted tax ID against the government database.                                                                  |
| `address_verification` | `Verified`, `Approximate Match`, `Unverified` | Submitted address against the address associated with the tax ID.                                                  |
| `registrationStatus`   | `Active`, `Inactive`, `Unknown`               | Registration status of the business. `Inactive` includes suspended businesses and those no longer in operation.    |
| `entityType`           | Legal entity type of the business             | The legal entity type of the company, if available. If not available, displays `Unknown`.                          |
| `ubo_name_match`       | `Verified`, `Approximate Match`, `Unverified` | Submitted UBO against UBOs associated with the business. Distinguished by the `uboName_input` field on each entry. |

### Error responses

See the [eKYB API Reference](https://developer.incode.com/docs/ekyb-api-reference) for standard error responses.

## Single Session Dashboard results

View eKYB results on the Business tab in [single Session view](https://developer.incode.com/docs/single-session-view).