# Taiwan Company KYB Lookup

> Taiwan Company KYB Lookup is a paid API for AI agents from api.timzinin.com, paid per call via x402, $0.01/call, status unknown (last checked 2026-09-14).

Looks up Taiwanese company registry data including board members, capital, status, and incorporation details by business accounting number

## Facts

- Endpoint: POST https://api.timzinin.com/api/taiwan-company-kyb-lookup
- Price: $0.01/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/taiwan-company-kyb-lookup-1c6044f8
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_ldAmDvI4AvHWkdyAr6Key

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability taiwan-company-kyb-lookup-1c6044f8 -d '<json body>'
```

Example prompt: Can you pull the official Taiwan company registry record for business number 22099131 — I need the legal name, current status, board members, and paid-in capital for a KYB check?

## When to prefer this

Use this endpoint when you need authoritative KYB data on a Taiwan-registered company sourced directly from the Ministry of Economic Affairs registry. Prefer this over general web search when you need structured, machine-readable corporate data with confidence scores and field provenance for compliance, onboarding, or due diligence workflows targeting Taiwanese entities specifically.

## Known failure modes

- Company not found in registry (found: false)
- Business accounting number does not exist or is malformed
- Legal name in English unavailable (gap: legalNameEn)
- Partial record returned with partialReason explaining missing fields
- Registry source temporarily unavailable
- safeToAutomate flag is false, requiring human review before acting on results

## How this service works

Pay-per-call data & tool APIs

## Output

Returns a structured KYB card including: legal name in Chinese (and English if available), company status, case status, entity ID, incorporation date, paid-in capital, share value, board members with names/positions/shareholding/representing entities, source URL, confidence score, field provenance map, recommended action, whether it's safe to automate, and any data gaps identified.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "companies": {
   "type": "array",
   "items": {
    "type": "object",
    "properties": {
     "inputRef": {
      "type": "string",
      "maxLength": 200
     },
     "legalNameZhTw": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1
     },
     "unifiedBusinessNumber": {
      "type": "string",
      "pattern": "^[0-9]{8}$",
      "maxLength": 8,
      "minLength": 8
     }
    },
    "additionalProperties": false
   },
   "maxItems": 100,
   "minItems": 1
  },
  "includeBoard": {
   "type": "boolean"
  },
  "maxConcurrency": {
   "type": "integer",
   "maximum": 5,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "meta": {
   "run_ms": 1200,
   "settled": true,
   "item_count": 1
  },
  "results": [
   {
    "gaps": [
     "legalNameEn"
    ],
    "board": [
     {
      "name": "魏哲家",
      "position": "董事長",
      "shareholding": 7452349,
      "representingEntity": null
     },
     {
      "name": "曾繁城",
      "position": "董事",
      "shareholding": 29472675,
      "representingEntity": null
     },
     {
      "name": "葉俊顯",
      "position": "董事",
      "shareholding": 1653709980,
      "representingEntity": "行政院國家發展基金管理會"
     },
     {
      "name": "彼得‧邦菲爵士",
      "position": "獨立董事",
      "shareholding": 0,
      "representingEntity": null
     },
     {
      "name": "麥克‧史賓林特",
      "position": "獨立董事",
      "shareholding": 0,
      "representingEntity": null
     },
     {
      "name": "摩西‧蓋弗瑞洛夫",
      "position": "獨立董事",
      "shareholding": 0,
      "representingEntity": null
     },
     {
      "name": "拉斐爾‧萊夫",
      "position": "獨立董事",
      "shareholding": 0,
      "representingEntity": null
     },
     {
      "name": "烏蘇拉‧伯恩斯",
      "position": "獨立董事",
      "shareholding": 0,
      "representingEntity": null
     },
     {
      "name": "琳恩‧埃爾森漢斯",
      "position": "獨立董事",
      "shareholding": 0,
      "representingEntity": null
     },
     {
      "name": "林全",
      "position": "獨立董事",
      "shareholding": 126826,
      "representingEntity": null
     }
    ],
    "error": null,
    "found": true,
    "source": "經濟部商業發展署商工行政資料開放平臺 (data.gcis.nat.gov.tw)",
    "status": "active",
    "partial": false,
    "entityId": "22099131",
    "inputRef": null,
    "errorCode": null,
    "retryable": false,
    "sourceUrl": "https://data.gcis.nat.gov.tw/od/data/api/5F64D864-61CB-4D0D-8AD9-492047CC1EA6?%24format=json&%24filter=Business_Accounting_NO+eq+22099131&%24skip=0&%24top=5",
    "caseStatus": "核准設立",
    "observedAt": "2026-08-15T05:29:24.035Z",
    "recordType": "kyb_company_card",
    "shareValue": 10,
    "legalNameEn": null,
    "legalNameZhTw": "台灣積體電路製造股份有限公司",
    "paidInCapital": 259323700670,
    "partialReason": null,
    "schemaVersion": "1.0",
    "safeToAutomate": false,
    "confidenceScore": 100,
    "fieldProvenance": {
     "status": "derived",
     "caseStatus": "registry",
     "shareValue": "registry",
     "legalNameEn": "unavailable",
     "legalNameZhTw": "registry",
     "paidInCapital": "registry",
     "incorporationDate": "derived",
     "registeredAddress": "registry",
    
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/taiwan-company-kyb-lookup-1c6044f8/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from api.timzinin.com](https://www.zero.xyz/host/api.timzinin.com/llms.txt)
