Guides · API

Chinese supplier check API (USCC, UFLPA, Entity List)

Use before paying or importing from a Chinese supplier: checks the 18-character Unified Social Credit Code (checksum, registration authority, entity type, province; Xinjiang is flagged), and screens the company against EU, UN, UK and US OFAC sanctions, the BIS Entity List, Military End User list and the DHS UFLPA Entity List. Verdict pass, review or block_review with reasons. Does not query the Chinese register (GSXT). Input: name, uscc.

0.03 USDC per call · GET /v1/china/supplier-check · free preview at /v1/china/supplier-check/preview

Parameters

Name	Required	Description
`name`	yes	Supplier name in Latin letters, as on the invoice
`uscc`	no	18-character Unified Social Credit Code from the business licence

Example request

curl "https://factline.dev/v1/china/supplier-check?name=Huawei+Technologies+Co.%2C+Ltd.&uscc=914403001922038216"
# 402 Payment Required: pay with an x402 client (USDC on Base or Solana), or send
# Authorization: Bearer <your Factline API key>

Example response

{
  "verdict": "block_review",
  "flags": [
    "possible match on BIS Entity List: Huawei Technologies Co., Ltd. (score 100)"
  ],
  "supplier": {
    "name": "Huawei Technologies Co., Ltd.",
    "uscc": {
      "code": "914403001922038216",
      "valid": true,
      "registration_authority": "market regulation (enterprises)",
      "entity_type": "enterprise (company)",
      "region_code": "440300",
      "province": "Guangdong"
    }
  }
}

Use it from an AI agent

Agents with an x402 wallet call the URL directly and pay per request. Assistants that speak MCP connect to https://factline.dev/mcp. Full reference: docs, OpenAPI, llms.txt. Businesses: API keys with a free trial.

Questions

How much does the Chinese supplier check API (USCC, UFLPA, Entity List) cost?

0.03 USDC per call, paid per request with x402 (no account), or included in a Factline API key plan with a free trial. Calls that fail are not charged.

Can I try it for free?

Yes: GET /v1/china/supplier-check/preview with the same parameters validates your input and shows what the paid answer contains, at no cost.

Where does the data come from?

Official public registers and open data, named with their licence in every response (source field) and at /.well-known/x402-license-provenance.