泰国企业数据 API(eKYB)
根据 13 位法人注册号,返回泰国公司或合伙企业的注册记录:状态、资本、行业、地址、董事、财务报表及信用风险评估。
数据库收录来自泰国法人登记的 1,751,616 家法人(2026 年 10 月 27 日),每家都有自己的数据日期 dataAsOf。数据是泰国商业发展厅公开发布的信息,由 iApp 收集并保存;iApp 不是政府机构,也不代表该厅。每个结果都在 meta.provenance 中注明来源。按注册号查询数据库在一秒内返回,按公司名称或人名搜索在 3 秒内返回。请先调用数据库端点。只有数据库中没有的公司,例如最近几天才注册的公司,才使用实时端点在调用时读取最新登记,并将该公司存入数据库,之后按数据库价格即可查到。
- 价格2 IC每次请求
- 累计调用26.6K次
所有结果仅供机构内部业务决策使用,不是法人证明,也不能作为法律证据(meta.notice)。首次调用前,请在 API Keys 页面或试用框中为您的账户接受一次 eKYB 条款。
请求
使用 GET,注册号放在路径中;批量查询使用 POST 和 JSON。法人以 13 位注册号(เลขทะเบียนนิติบุคคล)识别,该号码同时也是其税号。
请求头
apikeystring必填apikey 请求头中(也可用 x-api-key 或 Authorization: Bearer YOUR_API_KEY),切勿放在 URL 里,否则会留在浏览器和代理的日志中;放在查询字符串中的密钥返回 401。路径参数
company_idstring必填0135556015413。校验位错误的号码在计费前即被拒绝。查询参数
as_ofstring/snapshot:日期,如 2026-09-30,指泰国时间的整天;或 ISO 8601 日期加时间,时区偏移需 URL 编码,如 2026-09-30T12:00:00%2B07:00(不带偏移的时间按泰国时间)。其他格式(如 2026/09/30)返回 400,details.reason 为 invalid_format;佛历年份(如 2569-09-30)为 buddhist_era_year;晚于今天(泰国时间)的日期为 future_date,details.latest 给出今天。不传或传空值则返回当前版本。nameprovincestatustsicstring/company/search:name(泰文名称的一部分)为必填;province、status 和 tsic 为可选筛选条件,可任选或全部省略。府名拼写错误会被自动纠正;状态为注册登记所写的泰文,如 ยังดำเนินกิจการอยู่、ร้าง 或 เลิก,或登记的英文状态,如 Operating、Defunct 或 Dissolution(其他值返回 400,可用值见 details.allowed 和 details.allowedEnglish);tsic 为 5 位行业代码,如 62022。未同时提供三个筛选条件时,名称须含至少 3 个连续的字母或数字,且中间不能有泰文声调符号:ปตท 可以,น้ำ 不行,因为声调符号将其隔开(返回 400,原因为 name_too_short)。三个条件齐全时,2 个字符即可。先按名称部分匹配,未找到再按相似度匹配。此端点不搜索英文名称,请使用 /live/v1/company/search。namestring/person/search:泰文人名,可带或不带称谓;去掉称谓和军警衔后须至少剩 2 个字符(仅传 นาย 返回 400 INVALID_REQUEST)。常见姓名可能匹配数百人,请用 limit 和 offset 分页。namelimitstring/live/v1/company/search:name 必填,公司泰文或英文名称的一部分,至少 2 个字符;limit 返回的结果数,默认 10,最多 1,000,或 all。POST 以 JSON 传同样两项,如 {"name": "ไอแอพพ์", "limit": 20}。limitoffsetstring400,offset_too_large),须为直接书写的整数(1e2 或 020 返回 400;空值等同于不传)。在 /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} | 当场从最新登记获取的注册记录 | 4 IC |
GET /ekyb/live/v1/company/{company_id}/risk | 基于实时获取数据的风险评估 | 6 IC |
GET 或 POST /ekyb/live/v1/company/search | 按泰文或英文名称在最新登记中实时搜索公司:注册号、状态、府和最新年度数据 | 有结果时 2 IC,否则免费 |
仅对成功的响应计费:错误、未找到的公司和无结果的搜索均不收费。实时查询会先将该公司新增或更新到数据库中再返回,之后按数据库价格即可查到。数据库端点返回 404 COMPANY_NOT_IN_DB 或搜索无结果时,再使用实时端点。
响应
成功响应为 {"status": "success", "data": ..., "meta": ...}。面板显示的是注册记录。
idnamenameEngstringname 是登记本身的名称字段,前面不带法人类型(ไอแอพพ์เทคโนโลยี จำกัด);/financial、/risk 和搜索返回完整注册名称(บริษัท ไอแอพพ์เทคโนโลยี จำกัด)。typeOfEntityoperatingStatusstringtypeOfEntityEng 和 operatingStatusEng。registrationDateISOstringregistrationDate 为泰文格式,如 08 ส.ค. 2556。registerCapitalpaidCapitalnumber72005040437.5。tsicCodetsicCodeLatesttsicstring, objectaddressaddressDetailstring, objectdirectorspartnersmanaging_partnersarraytitle、firstName 和 lastName。公司有董事,合伙企业有合伙人。authorized_signatorystringhistoryChangeNamehistoryChangeCapitalarraysubmittedFiscalYearsarraymeta.provenanceobjectregistration、directors 和 financial,目前均为 dbd_public_website(泰国商业发展厅公开发布、由 iApp 收集的信息),以及 collectedBy。它不同于 meta.source,后者表示响应所来自的层。meta.noticestringAccept-Language: en 时为英文:数据截至 dataAsOf,仅供机构内部业务决策,不是法人证明或法律证据。/risk 另注明评分为 iApp 自行计算,不是授信建议。directors_hiddenpersons_redactedboolean, numberdirectors_hidden: true,董事、合伙人与签字人文字为空。persons_redacted 为应当事人请求未显示的姓名数。meta.sourcestringredis 或 db:读自数据库缓存或数据库本身;dbd:实时取自登记处。meta.dataAsOfstringmeta.last_seen_dataAsOf 为最后一次从登记处读取的时间,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 | 负债权益比(D/E)超过 4 倍;净资产为零或为负时无法评估 | 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。实时风险端点根据刚获取的董事名单,对照数据库中的其他公司评估该规则,因此同一记录的实时评分与数据库评分一致;数据库 2 秒内未响应时,该次调用将此规则列为无法评估。
/company/search 与 /person/search。 data 为数组;meta 含 totalItems、returned 和 hasMore(/person/search 中为 totalPersons 和 returnedPersons)。无结果时返回 HTTP 200 和空数组。在 /company/search 中,meta.filters 列出所用的筛选条件,meta.complete 表示列表是否完整:与大量公司匹配的名称(如不加筛选的 ไทย,约 100,000 家)最多读取 5,000 家匹配公司,因此列表不完整,totalItems 为下限,meta.hint 提示输入更完整的名称或增加筛选条件,排序(最相似者优先,其次营收较高者)仅在已读取的公司中进行。在 /person/search 中,meta.complete 的含义相同:与大量人员匹配的名称(如常见的短名称片段 ศรี)最多读取 10,000 条匹配记录,因此列表不完整,totalPersons 为下限,meta.hint 提示输入更完整的姓名;姓名完全匹配的人始终排在首位,每人的 totalCompanies 为准确数。每个人附带其任职公司,最多 50 家,每家注明 role:director、partner 或 managing_partner。姓名不代表身份:登记信息不公开身份证号,同名同姓者会合并为一条,meta.confidence 始终为 name_only。
/live/v1/company/search。 在调用时按名称搜索最新登记,支持泰文和英文。data.results 列出匹配结果,每条含 company_id、name、nameEng、typeOfEntity、operatingStatus、tsicCode、tsicDescription 和 province,以及最近提交年度的 registerCapitalTHB、totalRevenueTHB、netProfitTHB、totalAssetsTHB 和 shareholderEquityTHB(带千位分隔符的文本),对应佛历 fiscalYear。data.totalItems 为登记中全部匹配数,结果多于 returned 时 truncated 为 true。结果总是从第一条开始,请输入更完整的名称来缩小范围,而不是翻页。无匹配时会去掉 บริษัท、จำกัด 等词重试,keywordUsed 给出实际匹配的词。无结果返回 404 COMPANY_NOT_FOUND,不计费。登记处每页返回 10 个名称,每多取 10 条尚未缓存的结果约增加 1 秒;1 小时内的相同搜索由缓存在 0.1 秒内返回。如需完整记录,用 /ekyb/v1/company/{company_id} 查询 company_id;若返回 404 COMPANY_NOT_IN_DB,请改用 /ekyb/live/v1/company/{company_id},4 IC,登记处没有该公司时不计费。搜索结果示例(部分):
{
"status": "success",
"data": {
"keyword": "บริษัท ไอแอพพ์เทคโนโลยี จำกัด",
"keywordUsed": "ไอแอพพ์เทคโนโลยี",
"totalItems": 1,
"returned": 1,
"limit": 10,
"truncated": false,
"results": [
{
"company_id": "0135556015413",
"name": "ไอแอพพ์เทคโนโลยี จำกัด",
"nameEng": "I APP TECHNOLOGY COMPANY LIMITED",
"typeOfEntity": "บริษัทจำกัด",
"operatingStatus": "ยังดำเนินกิจการอยู่",
"tsicCode": "62022",
"province": "ปทุมธานี",
"registerCapitalTHB": "31,500,000.00",
"totalRevenueTHB": "24,779,480.39",
"netProfitTHB": "241,556.87",
"fiscalYear": "2568"
}
]
},
"meta": { "fetchedAt": "28/10/2026 11:34:32", "requestId": "bbb26a9418635f91cbedde9d297d5997" }
}
/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 指明是哪个,例如 as_of 格式或日期无效时 reason 为 invalid_format 或 invalid_date,as_of 晚于今天时为 future_date,状态不是登记使用的值时为 unknown_status,人名去掉称谓后不足 2 个字符,或公司名称在筛选条件不全时没有 3 个连续字母或数字时为 name_too_short,offset 超过 10,000 时为 offset_too_large,参数含 NUL 字符 %00 时为 nul_character),或超过 50 个号码 |
| 400 | KEYWORD_REJECTED | 实时名称搜索:登记处不接受过于宽泛的词,如 บริษัท,请输入更具体的名称 |
| 403 | EKYB_TERMS_REQUIRED | 账户尚未接受现行 eKYB 条款;details.required、details.accepted 和 details.acceptUrl 说明版本与接受位置 |
| 403 | PAID_ACCOUNT_REQUIRED | 从未购买积分的账户调用 /person/search |
| 404 | COMPANY_NOT_IN_DB | 数据库中没有。请核对号码;近几天新注册的公司可用实时查询获取 |
| 404 | COMPANY_NOT_FOUND | 实时查询或实时名称搜索:登记中无此号码或名称的法人;/financial:数据库记录显示登记中无此号码的法人 |
| 404 | SNAPSHOT_NOT_FOUND | 日期早于该记录历史的起点;details.historyFrom 给出最早日期 |
| 404 | ENDPOINT_NOT_FOUND | /ekyb 下没有该路径。只由字母、连字符或空格组成的公司号码(如 abc)会被视为路径,因此返回此代码而非 INVALID_JURISTIC_ID |
| 405 | METHOD_NOT_ALLOWED | 该路径不接受此方法,例如用 GET 调用 /batch;Allow 头列出可用方法。凡可用 GET 之处均可用 HEAD,计费相同 |
| 413 | PAYLOAD_TOO_LARGE | 批量请求体超过 16 KB |
| 429 | DAILY_COMPANY_QUOTA | 账户当天已查询 1,000 家不同的公司;见 details.limit、details.used 和 details.resetsAt(曼谷时间午夜)。当天已查询过的公司仍可查询 |
| 429 | SERVICE_BUSY | 实时端点:登记处获取任务已满,请在 details.retryAfterSeconds 之后重试(不同于网关 的 429,后者没有 code) |
| 502 | UPSTREAM_ERROR、UPSTREAM_INCOMPLETE | 实时端点:登记处返回错误或数据不完整(不完整的数据不会保存),请稍后重试 |
| 503 | REQUEST_TIMEOUT、UPSTREAM_RATE_LIMITED | 实时端点:登记处 25 秒内未响应(请求超过 100 条结果的实时名称搜索为 60 秒)或正在限流。请在 details.retryAfterSeconds 之后重试 |
| 503 | UPSTREAM_AUTH_FAILED | 实时端点:与登记处的连接暂时故障,请在 details.retryAfterSeconds 之后重试 |
| 503 | DB_TIMEOUT、DB_UNAVAILABLE | 数据库端点:搜索超过 3 秒(例如名称过短)或数据库不可用。这不表示没有数据,请重试或输入更长的名称 |
| 500 | INTERNAL_ERROR | 内部错误,请将 requestId 告知 iApp |
所有错误均不计费;带有 details.retryAfterSeconds 的错误同时返回 Retry-After 头。message 为泰文;发送 Accept-Language: en 可获得英文。
缺少或错误的密钥由网关返回 401,超出速率限制返回 429,格式为 {"message": ..., "request_id": ...},不含 code;服务自身的 429 均带有 code。
限制
- 数据库端点:每个密钥每秒 100 次请求。2026 年 10 月 29 日实测响应时间中位数 0.07 秒,95% 不超过 0.10 秒,最快 0.05 秒,最慢 0.16 秒;由位于曼谷的调用方经
api.iapp.co.th测得,包含网络传输,共 120 次请求,即从数据库随机抽取的 40 家公司的公司信息、财务报表和风险评估;其中服务端处理时间中位数为 9 毫秒。按公司名称或人名搜索的上限为 3 秒,超时返回503 DB_TIMEOUT,不计费。 - 实时端点:每个密钥每分钟 30 次请求,查询和风险端点合并计数,名称搜索单独计数。2026 年 10 月 27 日实测实时查询耗时 1.0 秒;登记处响应缓慢时最多等待 25 秒(请求超过 100 条结果的实时名称搜索最多 60 秒),随后返回
503及重试时间,不计费。 - 每个账户每天最多查询 1,000 家不同的公司,所有端点合计,包括搜索结果中的条目;当天已查询过的公司不重复计数。以曼谷时间午夜为界。如需更多,请联系 sale@iapp.co.th。
- 从未购买积分的账户不会获得人员姓名(
directors_hidden: true),也不能使用/person/search。 - 不含股东名册(บอจ.5)和最终受益人:
shareholders和ubo为空,ubo_available为false。
数据处理
使用 eKYB 即表示接受iApp eKYB 使用条款。要点如下:
- 来源:泰国商业发展厅公开发布、由 iApp 收集并保存的信息,见
meta.provenance;实时调用在调用时读取登记。iApp 不是登记机关,也不认证数据。 - 允许的用途:贵机构内部决策,如 KYB、客户尽职调查、授信与供应商核查。
- 禁止事项:公开发布、转售、复制到其他数据库,或将人员姓名用于营销。
- 不作保证与错误报告:数据截至
dataAsOf,可能与今日登记不同。错误请报告至 support@iapp.co.th;登记本身须向泰国商业发展厅更正。 - 数据中列名的人员:董事与合伙人姓名属于个人数据,您是所获数据的控制者。当事人的告知见董事与合伙人隐私声明,可通过请求表提出反对;反对被受理后,该姓名不会出现在任何结果中(
persons_redacted)。 - 日志:每次调用都会记录调用账户及查询内容,用于计费、支持和防止滥用。