Taiwan Company KYB Lookup
Pricing
from $17.00 / 1,000 resolved kyb company cards
Resolve Taiwan companies (統一編號 or legal name) to an evidence-backed KYB card from the official MOEA GCIS open-data registry. Free structural checks, free not-found/ambiguous/error outcomes; billed only for a complete, unambiguous company card.
Record type
recordType
Required
Fixed discriminator for every row this Actor produces.
Schema version
schemaVersion
Required
Version of this flat output contract.
統一編號 (Unified Business Number)
entityId
Required
The company's real Business_Accounting_NO as returned by the registry. Populated only once the registry has positively identified exactly one real company for this row (the billable resolved row, a partial_source_coverage row that got at least that far, and a duplicate_entity row naming which already-billed company this repeat pointed at). Deduplication is per RUN: submitting the same company twice in one run is free the second time, but submitting it by number in one run and by name in another run is charged in each run, because the delivery journal is keyed on the submitted text rather than the resolved company. Null on every other free outcome: a number that never passed the checksum is not a real UBN, and a search that found zero or more than one candidate never identified a single company to name.
Caller reference
inputRef
Required
The optional opaque caller reference copied from the matching input company exactly as supplied, including any leading, trailing, repeated or tab whitespace. Null when the input did not supply one.
Legal name (traditional Chinese)
legalNameZhTw
Required
The company's registered name as published by the registry (Company_Name). Null when no company was identified.
Legal name (English)
legalNameEn
Required
Always null. No English name field exists in either GCIS open-data resource this Actor reads; this row's gaps always names legalNameEn rather than leaving its absence silent. A buyer is never charged for a field the source does not have.
Status (normalized)
status
Required
Coarse, buyer-filterable status derived from caseStatus. "unknown" whenever the raw source text is not one of the small set of statuses this build maps with confidence, rather than guessing a direction. Null when no company was identified.
Case status (raw, Chinese)
caseStatus
Required
The registry's own status text verbatim (Company_Status_Desc, e.g. 核准設立). Null when no company was identified.
Incorporation date
incorporationDate
Required
Company_Setup_Date converted from the ROC calendar (gregorian year minus 1911) to an ISO 8601 date. Null when the source value is missing, malformed, or does not round-trip to a real calendar date; a wrong date is worse than a missing one, so this field is never guessed.
Legal representative
legalRepresentative
Required
The company's registered responsible person (Responsible_Name). Null when no company was identified.
Registered capital (資本總額, TWD)
registeredCapital
Required
Capital_Stock_Amount from the registry, in New Taiwan Dollars. Null when the source omits or does not publish a parseable number for this field.
Paid-in capital (實收資本額, TWD)
paidInCapital
Required
Paid_In_Capital_Amount from the registry, in New Taiwan Dollars. Best-effort enrichment, not required for the billable outcome: null when the source omits or does not publish a parseable number, in which case paidInCapital is also named in gaps.
Registered address
registeredAddress
Required
Company_Location from the registry. Null when no company was identified.
Registering authority
registeringAuthority
Required
Register_Organization_Desc from the registry, the government body that holds this registration. Null when no company was identified.
Board of directors and supervisors
board
Required
Directors, supervisors and their shareholding, from the registry's board resource. Always [] when includeBoard was false in the input (never attempted), when the company legitimately has no separately-listed board on file, or when no company was identified. Personal data of living people: names and shareholding published by the government registry for public viewing, carried through unenriched.
Source
source
Required
Always the same fixed identity: this Actor reads exactly one government registry and no other, by design (SPEC.md's 'one service per Actor' rule).
Source URL
sourceUrl
Required
The exact registry API request this row's outcome came from. Null only when no request was ever made, i.e. checksum_invalid (rejected before any network call).
Source timestamp
sourceTimestamp
Required
UTC timestamp when the registry response this row is built from was received. Null only when no request was ever made.
Field provenance
fieldProvenance
Required
Per-field origin map ("registry", "derived", or "unavailable") for the identity and financial fields on this row, so a buyer can tell a value read verbatim from the source apart from one this Actor computed (e.g. incorporationDate's calendar conversion, status's normalization). Empty object when no company was identified.
Confidence score
confidenceScore
Required
0-100 confidence that the identified record is the intended company: 100 for an exact 統一編號 match, 90 for a name search that returned exactly one candidate. Null when no company was identified.
Gaps
gaps
Required
Names of promised output fields this row could not populate from the source, so a buyer never learns about a missing field by silence. Always includes legalNameEn whenever a company was identified (the field never exists at the source). Empty on every outcome that never reached an identified company.
Recommended action
recommendedAction
Required
Human-readable next step for the buyer given this row's outcome. Null when no specific action applies.
Safe to automate
safeToAutomate
Required
Always false. This card is a registry excerpt for human KYB review; it never certifies a counterparty decision, automatically or otherwise.
Partial
partial
Required
True when the row could not be completed in full. That covers the registry answering without a required field or without the full board, and also a run that failed before or during the request, so partial does not imply the registry was reached. A partial row is always free, never billed.
Partial reason
partialReason
Required
Machine-readable code for what was incomplete inside a partial_source_coverage row. Null when partial is false.
Verification status
verificationStatus
Required
The row's outcome. "resolved" is the only billable value; every other value is one of the free outcomes from the product contract and mirrors errorCode.
Error code
errorCode
Required
Machine-readable free-outcome code from the product contract's error table. Null only on the billable resolved row; every free row carries exactly one of these codes.
Error message
error
Required
Human-readable message accompanying errorCode. Null only on the billable resolved row.
Retryable
retryable
Required
Whether the caller can expect a different result from retrying this same company unchanged. True for rate_limited; class-dependent for source_error; false for every other outcome including the billable resolved row, which has nothing to retry.
Observed at
observedAt
Required
UTC timestamp when this row's outcome was produced.
Billable match
found
Required
True only when verificationStatus is resolved; this is the row's billing boundary.
