泰国企业数据 API（eKYB）

根据 13 位法人注册号，返回泰国公司或合伙企业的注册记录：状态、资本、行业、地址、董事、财务报表及信用风险评估。

数据库收录泰国商业发展厅（DBD）登记的全部 1,751,616 家法人（2026 年 10 月 27 日）。数据库查询在一秒内返回；对于注册时间晚于数据库副本的公司，实时端点会在调用时从 DBD 获取。

GET/ekyb/v1/company/0135556015413

另有 1 个端点

试一试

价格2 IC每次请求

运行中

登录后即可试用。

注册即获 50 点免费额度，无需绑卡

免费注册登录

登录后即可试用。

注册即获 50 点免费额度，无需绑卡

免费注册登录

请求

curl -X GET "https://api.iapp.co.th/ekyb/v1/company/0135556015413" \
  -H "apikey: YOUR_API_KEY"

响应

200成功。字段在"响应"一节说明。

{
  "status": "success",
  "data": {
    "id": "0135556015413",
    "name": "ไอแอพพ์เทคโนโลยี จำกัด",
    "nameEng": "I APP TECHNOLOGY COMPANY LIMITED",
    "typeOfEntity": "บริษัทจำกัด",
    "operatingStatus": "ยังดำเนินกิจการอยู่",
    "operatingStatusEng": "Operating",
    "registrationDateISO": "2013-08-08",
    "registerCapital": 31500000,
    "tsicCodeLatest": "62022",
    "submittedFiscalYears": [2568, 2567, 2566, 2565, 2564],
    "addressDetail": { "province": "ปทุมธานี", "zipCode": "12120" },
    "directors": [
      { "title": "นาย", "firstName": "กอบกฤตย์", "lastName": "วิริยะยุทธกร" }
    ]
  },
  "meta": { "source": "redis", "sourceMode": "cache", "dataAsOf": "2026-10-25" }
}

请求

使用 GET，注册号放在路径中；批量查询使用 POST 和 JSON。法人以 13 位注册号（เลขทะเบียนนิติบุคคล）识别，该号码同时也是其税号。

请求头

apikeystring必填

您的 API 密钥，在控制面板的 API Keys 中创建。

路径参数

company_idstring必填

13 位注册号，如 0135556015413。校验位错误的号码在计费前即被拒绝。

查询参数

as_ofstring

用于 /snapshot：日期，如 2026-09-30；或日期加时间，时区偏移需 URL 编码，如 2026-09-30T12:00:00%2B07:00。不传则返回当前版本。

nameprovincestatustsicstring

用于 /company/search，四项均为必填：泰文名称的一部分；府名（拼写错误会被自动纠正）；注册登记所写的泰文状态，如 ยังดำเนินกิจการอยู่、ร้าง 或 เลิก；以及 5 位行业代码（TSIC），如 62022。先按名称部分匹配，未找到再按相似度匹配。

namestring

用于 /person/search：泰文人名，可带或不带称谓，至少 2 个字符。

limitoffsetstring

用于搜索：每页数量，默认 20，最多 200，以及起始位置。在 /person/search 中按人数计算，而非公司数。

请求体

idsfieldsbody

用于 /batch：{"ids": ["0135556015413", "..."], "fields": "summary"}，最多 50 个号码、16 KB。summary 返回每家的名称、府、行业代码和状态；full 返回完整记录。

端点	返回	价格
`GET /ekyb/v1/company/{company_id}`	注册记录	2 IC
`GET …/{company_id}/financial`	最多五个财年的财务报表及提交状态	1 IC
`GET …/{company_id}/risk`	10 项风险规则及 0 至 100 的风险分	2 IC
`GET …/{company_id}/snapshot`	指定日期时的记录	免费
`POST /ekyb/v1/company/batch`	一次最多 50 家公司	每家查到的公司 2 IC
`GET /ekyb/v1/company/search`	按泰文名称、府、状态和行业查询公司	有结果时 1 IC，否则免费
`GET /ekyb/v1/person/search`	某人担任董事或合伙人的公司	有结果时 2 IC，否则免费
`GET /ekyb/live/v1/company/{company_id}`	当场从 DBD 获取的注册记录	4 IC
`GET /ekyb/live/v1/company/{company_id}/risk`	基于实时获取数据的风险评估	6 IC
`GET` 或 `POST /ekyb/live/v1/company/search`	DBD 自身的名称搜索，返回号码和名称，不含完整记录	2 IC

仅对成功的响应计费：错误、未找到的公司和无结果的搜索均不收费。实时查询还会将该公司新增或更新到数据库中，之后按数据库价格即可查到。

响应

成功响应为 {"status": "success", "data": ..., "meta": ...}。面板显示的是注册记录。

idnamenameEngstring

注册号及注册名称。

typeOfEntityoperatingStatusstring

泰文的法人类型和状态，另有 typeOfEntityEng 和 operatingStatusEng。

registrationDateISOstring

注册日期；registrationDate 为泰文格式，如 08 ส.ค. 2556。

registerCapitalpaidCapitalnumber

单位为泰铢。

tsicCodetsicCodeLatesttsicstring, object

注册时的行业代码和最新申报的行业代码，附泰文和英文说明。

addressaddressDetailstring, object

注册地址，以及含府、县、区代码的分项地址。

directorspartnersmanaging_partnersarray

每人含 title、firstName 和 lastName。公司有董事，合伙企业有合伙人。

authorized_signatorystring

登记的签字权限。

historyChangeNamehistoryChangeCapitalarray

每次变更及其日期。

submittedFiscalYearsarray

已提交报表的财年（佛历）。

meta.sourcestring

redis 或 db 表示读自数据库；dbd 表示实时获取。

meta.dataAsOfstring

DBD 最后更新该记录的日期。meta.last_seen_dataAsOf 为最后一次从 DBD 读取的时间，meta.updated_dataAsOf 为内容最后一次变化的时间。

财务报表、风险、搜索与批量查询

/financial。 先看 financialStatus 再看数字：ok，已提交报表；never_submitted，从未提交，这是确定的结论；expected_but_missing，应有报表但尚未取得，不能理解为"没有报表"；fetch_error，获取失败。summary 给出最近一年的收入、利润或亏损和总资产；financial 按年份包含资产负债表、利润表和财务比率。

/risk。 risk_score 取值 0 至 100，越高风险越大，并非征信机构的信用分。risk_level 低于 20 为 low，20 起为 medium，50 起为 high。每条触发的规则列在 risk_flags 中，含 code、severity、weight 和 evidence。无法评估的规则（例如缺少财务报表）列在 risk_coverage.unavailable 中：没有标志不等于已检查且无问题。

规则	触发条件	权重
`INACTIVE_STATUS`	状态为 ร้าง、เลิก、เสร็จการชำระบัญชี、ล้มละลาย 或 พิทักษ์ทรัพย์	40
`NO_FILING_2Y`	连续 2 年未提交报表（从未提交则为 15）	25
`NEGATIVE_EQUITY`	股东权益为负	25
`LOSS_3Y`	连续 3 年亏损	20
`DIRECTOR_LINKED_STRUCK_OFF`	某董事或合伙人在 3 家及以上被除名公司任职	15
`PEER_LEVERAGE_TSIC`	负债权益比远高于同行业代码的公司	10
`REVENUE_DROP_YOY`	收入较上年下降 30% 及以上	10
`FREQUENT_CHANGES`	3 年内更名 2 次或变更资本 3 次	10
`CAPITAL_VS_REVENUE_LOW`	收入达 1,000 万泰铢及以上时，注册资本低于收入的 1%	5
`YOUNG_HIGH_CAPITAL`	成立不足 2 年而注册资本达 500 万泰铢及以上	5

DIRECTOR_LINKED_STRUCK_OFF 在董事兼任多家公司的大型集团中很常见；仅此一项时公司仍为 low。实时风险端点无法评估该规则，会将其列为无法评估。

/company/search 与 /person/search。 data 为数组；meta 含 totalItems、returned 和 hasMore（/person/search 中为 totalPersons 和 returnedPersons）。无结果时返回 HTTP 200 和空数组。每个人附带其任职公司，最多 50 家，每家注明 role：director、partner 或 managing_partner。姓名不代表身份：登记信息不公开身份证号，同名同姓者会合并为一条，meta.confidence 始终为 name_only。

/batch。 data 按发送顺序列出号码，每条含 found，未找到时含 reason；meta 统计 requested、found、notInDb、invalid 和 duplicates。仅对查到的公司计费。

/snapshot。 记录结构与普通查询相同。历史自 2026 年 8 月 28 日起保存，记录每变化一次保存一个版本：meta.versions 为版本数，meta.historyFrom 为该公司可查询的最早日期，meta.validFrom 和 meta.validTo 为返回版本的有效期间。

详情

错误

错误响应为 {"status": "error", "error": {"code", "message", "details", "requestId"}}。请依据 code 处理，message 的措辞可能变化。

HTTP	`code`	含义
400	`INVALID_JURISTIC_ID`	不是 13 位或校验位错误；`details.reason` 说明是哪种
400	`INVALID_REQUEST`、`BATCH_TOO_LARGE`	参数缺失或无效（`details` 指明是哪个），或超过 50 个号码
404	`COMPANY_NOT_IN_DB`	数据库中没有。请核对号码；近几天新注册的公司可用实时查询获取
404	`COMPANY_NOT_FOUND`	实时查询：DBD 无此号码的法人
404	`SNAPSHOT_NOT_FOUND`	日期早于该记录历史的起点；`details.historyFrom` 给出最早日期
413	`PAYLOAD_TOO_LARGE`	批量请求体超过 16 KB
503	`REQUEST_TIMEOUT`、`UPSTREAM_RATE_LIMITED`	实时端点：DBD 25 秒内未响应或正在限流。请在 `details.retryAfterSeconds` 之后重试

缺少或错误的密钥由网关返回 401，超出速率限制返回 429，格式为 {"message": ...}。

限制

数据库端点：每个密钥每秒 100 次请求；在我们 2026 年 10 月 27 日的测试中，端到端响应时间为 0.16 至 0.74 秒。
实时端点：每个密钥每分钟 30 次请求，查询和风险端点合并计数，名称搜索单独计数。同一测试中实时查询耗时 1.0 秒；DBD 响应缓慢时最多等待 25 秒，随后返回 503 及重试时间。
不含股东名册（บอจ.5）和最终受益人：shareholders 和 ubo 为空，ubo_available 为 false。

数据处理

数据来自 DBD 的公开登记信息。其中董事和合伙人的姓名属于个人数据：仅可用于合法目的，例如 KYB、信用或供应商审查，并须具备您自身依据 PDPA 的合法基础。请求连同调用的密钥会被记录，用于计费和支持。

请求​

响应​

详情​

请求

响应

详情