API ข้อมูลนิติบุคคลไทย (eKYB)

ส่งเลขทะเบียนนิติบุคคล 13 หลัก แล้วได้ข้อมูลจดทะเบียนของบริษัทหรือห้างหุ้นส่วน ได้แก่ สถานะ ทุน ประเภทธุรกิจ ที่อยู่ กรรมการ งบการเงิน และผลประเมินความเสี่ยงด้านเครดิต

ฐานข้อมูลมีนิติบุคคลครบทั้ง 1,751,616 รายในทะเบียนของกรมพัฒนาธุรกิจการค้า (DBD) (ข้อมูล ณ 27 ตุลาคม 2569) การค้นจากฐานข้อมูลตอบภายในหนึ่งวินาที ส่วนบริษัทที่จดทะเบียนใหม่กว่าข้อมูลในฐาน ให้ใช้เส้นดึงสด ซึ่งดึงจาก DBD ณ เวลาที่เรียก

GET/ekyb/v1/company/0135556015413

และอีก 1 endpoint

ทดลองใช้

• ราคา2 ICต่อครั้ง

• ใช้งานได้

เข้าสู่ระบบเพื่อทดลองใช้งาน

สมัครแล้วได้ 50 เครดิตฟรี ไม่ต้องผูกบัตร

สมัครบัญชีฟรีเข้าสู่ระบบ

เข้าสู่ระบบเพื่อทดลองใช้งาน

สมัครแล้วได้ 50 เครดิตฟรี ไม่ต้องผูกบัตร

สมัครบัญชีฟรีเข้าสู่ระบบ

Request

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

Response

200OK ฟิลด์อธิบายไว้ในหัวข้อ Response

{
  "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 โดยใส่เลขทะเบียนใน path ส่วนการค้นทีละหลายเลขใช้ POST กับ JSON นิติบุคคลระบุด้วยเลขทะเบียน 13 หลัก ซึ่งเป็นเลขประจำตัวผู้เสียภาษีด้วย

Headers

apikeystringrequired

API key ของคุณ สร้างได้ที่เมนู API Keys ในแผงควบคุม

Path

company_idstringrequired

เลขทะเบียนนิติบุคคล 13 หลัก เช่น 0135556015413 เลขที่หลักตรวจสอบไม่ถูกต้องจะถูกปฏิเสธก่อนคิดเงิน

Query

as_ofstring

สำหรับ /snapshot: วันที่ เช่น 2026-09-30 หรือวันที่และเวลา โดยเข้ารหัส offset ใน URL เช่น 2026-09-30T12:00:00%2B07:00 ถ้าไม่ส่งจะได้เวอร์ชันปัจจุบัน

nameprovincestatustsicstring

สำหรับ /company/search ต้องส่งครบทั้งสี่: ชื่อภาษาไทยบางส่วน จังหวัด (พิมพ์ผิดได้ ระบบแปลงให้) สถานะภาษาไทยตามที่ทะเบียนเขียน เช่น ยังดำเนินกิจการอยู่ร้าง หรือ เลิก และรหัสประเภทธุรกิจ (TSIC) 5 หลัก เช่น 62022 ระบบค้นชื่อแบบมีคำนั้นอยู่ข้างในก่อน ไม่เจอจึงค้นแบบใกล้เคียง

namestring

สำหรับ /person/search: ชื่อบุคคลภาษาไทย มีหรือไม่มีคำนำหน้าก็ได้ อย่างน้อย 2 ตัวอักษร

limitoffsetstring

สำหรับการค้นหา: จำนวนต่อหน้า ค่าเริ่มต้น 20 สูงสุด 200 และตำแหน่งเริ่มต้น ใน /person/search นับเป็นจำนวนคน ไม่ใช่จำนวนบริษัท

Body

idsfieldsbody

สำหรับ /batch: {"ids": ["0135556015413", "..."], "fields": "summary"} ไม่เกิน 50 เลข และไม่เกิน 16 KB โดย summary ให้ชื่อ จังหวัด รหัสธุรกิจ และสถานะของแต่ละราย ส่วน full ให้ข้อมูลเต็ม

เส้น	ได้อะไร	ราคา
GET /ekyb/v1/company/{company_id}	ข้อมูลจดทะเบียน	2 IC
GET …/{company_id}/financial	งบการเงินสูงสุด 5 ปีงบประมาณ และสถานะการส่งงบ	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

คิดเงินเฉพาะคำตอบที่สำเร็จ: ข้อผิดพลาด บริษัทที่ไม่พบ และการค้นที่ไม่เจอ ไม่เสีย IC การดึงสดยังเพิ่มหรือปรับปรุงบริษัทนั้นในฐานข้อมูลด้วย ครั้งต่อไปจึงค้นได้ในราคาฐานข้อมูล

คำตอบ

คำตอบที่สำเร็จอยู่ในรูป {"status": "success", "data": ..., "meta": ...} แผงด้านข้างแสดงข้อมูลจดทะเบียน

idnamenameEngstring

เลขทะเบียน และชื่อที่จดทะเบียน

typeOfEntityoperatingStatusstring

ประเภทนิติบุคคลและสถานะเป็นภาษาไทย พร้อม typeOfEntityEng และ operatingStatusEng

registrationDateISOstring

วันที่จดทะเบียน ส่วน registrationDate เป็นรูปแบบไทย เช่น 08 ส.ค. 2556

registerCapitalpaidCapitalnumber

หน่วยเป็นบาท

tsicCodetsicCodeLatesttsicstring, object

รหัสประเภทธุรกิจตอนจดทะเบียนและรหัสล่าสุดที่ยื่น พร้อมคำอธิบายภาษาไทยและอังกฤษ

addressaddressDetailstring, object

ที่อยู่จดทะเบียน และแยกส่วนพร้อมรหัสจังหวัด อำเภอ และตำบล

directorspartnersmanaging_partnersarray

แต่ละคนมี titlefirstName และ 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 เป็น low เมื่อต่ำกว่า 20 · medium ตั้งแต่ 20 · high ตั้งแต่ 50 กฎที่ขึ้นธงอยู่ใน 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	เปลี่ยนชื่อ 2 ครั้ง หรือเปลี่ยนทุน 3 ครั้ง ภายใน 3 ปี	10
CAPITAL_VS_REVENUE_LOW	ทุนจดทะเบียนต่ำกว่า 1% ของรายได้ เมื่อรายได้ตั้งแต่ 10 ล้านบาท	5
YOUNG_HIGH_CAPITAL	อายุไม่ถึง 2 ปี แต่ทุนจดทะเบียนตั้งแต่ 5 ล้านบาท	5

DIRECTOR_LINKED_STRUCK_OFF พบบ่อยในกลุ่มบริษัทใหญ่ ซึ่งกรรมการนั่งหลายบริษัท ธงนี้ธงเดียวยังคงระดับ low ส่วนเส้นประเมินความเสี่ยงแบบดึงสดประเมินกฎนี้ไม่ได้ และจะระบุว่าประเมินไม่ได้

/company/search และ /person/search data เป็น array และ meta มี totalItems returned และ hasMore (ใน /person/search เป็น totalPersons และ returnedPersons) ค้นไม่เจอได้ HTTP 200 กับ array ว่าง แต่ละคนมาพร้อมรายชื่อบริษัทไม่เกิน 50 แห่ง แต่ละแห่งระบุ role คือ director partner หรือ managing_partner ชื่อไม่ใช่การยืนยันตัวตน: ทะเบียนไม่เปิดเผยเลขประจำตัวประชาชน คนชื่อและนามสกุลเดียวกันจึงรวมเป็นรายการเดียว และ meta.confidence เป็น name_only เสมอ

/batch data เรียงตามลำดับเลขที่ส่ง แต่ละรายการมี found และถ้าไม่พบมี reason ส่วน meta นับ requested found notInDb invalid และ duplicates คิดเงินเฉพาะบริษัทที่พบ

/snapshot ข้อมูลมีรูปแบบเดียวกับการค้นปกติ ระบบเก็บประวัติตั้งแต่ 28 สิงหาคม 2569 หนึ่งเวอร์ชันทุกครั้งที่ข้อมูลเปลี่ยน: 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	body ของ batch เกิน 16 KB
503	REQUEST_TIMEOUT, UPSTREAM_RATE_LIMITED	เส้นดึงสด: DBD ไม่ตอบภายใน 25 วินาที หรือกำลังจำกัดการเข้าถึง ให้ลองใหม่หลัง details.retryAfterSeconds

gateway ตอบ 401 เมื่อไม่ส่ง key หรือ key ไม่ถูกต้อง และ 429 เมื่อเกินอัตราที่กำหนด ในรูป {"message": ...}

ข้อจำกัด

• เส้นฐานข้อมูล: 100 คำขอต่อวินาทีต่อ key ในการทดสอบของเราเมื่อ 27 ตุลาคม 2569 ตอบภายใน 0.16 ถึง 0.74 วินาที นับรวมการเดินทางของคำขอทั้งหมด
• เส้นดึงสด: 30 คำขอต่อนาทีต่อ key โดยการค้นข้อมูลและการประเมินความเสี่ยงนับรวมกัน ส่วนการค้นชื่อนับแยก ในการทดสอบเดียวกัน การดึงสดใช้เวลา 1.0 วินาที เมื่อ DBD ตอบช้า คำขอจะรอได้ถึง 25 วินาที แล้วตอบ 503 พร้อมเวลาที่ควรลองใหม่
• ไม่มีรายชื่อผู้ถือหุ้น (บอจ.5) และผู้รับประโยชน์ที่แท้จริง: shareholders และ ubo เป็นค่าว่าง และ ubo_available เป็น false

การจัดการข้อมูล

ข้อมูลมาจากทะเบียนสาธารณะของ DBD ชื่อกรรมการและผู้เป็นหุ้นส่วนเป็นข้อมูลส่วนบุคคล ใช้ได้เฉพาะเพื่อวัตถุประสงค์ที่ชอบด้วยกฎหมาย เช่น การตรวจสอบ KYB เครดิต หรือคู่ค้า ภายใต้ฐานทางกฎหมายตาม PDPA ของคุณเอง ระบบบันทึกคำขอพร้อม key ที่เรียก เพื่อการคิดเงินและการให้บริการ