answers
A flat map of question_key → value object. OCR output from the document, whatever
the applicant typed, and any input parameters you passed at creation.
What appears here depends on how you built the form. The keys below are the standard eKYC fields. Every element you add in the Builder — extra questions, input parameters — arrives in this same object with the same shape, and so does every answer you pre-filled at creation.
{ "answers": { "consent_version": { "value": "", "created_at": "2026-08-26T09:51:09.072084+00:00", "updated_at": "2026-08-26T09:51:09.072096+00:00" }, "consent_date": { "value": "2026-08-26T09:51:06.156Z", "created_at": "2026-08-26T09:51:09.072168+00:00", "updated_at": "2026-08-26T09:51:09.072173+00:00" }, "consent_checkbox_1": { "value": true, "created_at": "2026-08-26T09:51:09.072227+00:00", "updated_at": "2026-08-26T09:51:09.072233+00:00" }, "ekyc_document_type": { "value": "passport", "created_at": "2026-08-26T09:51:14.907185+00:00", "updated_at": "2026-08-26T09:51:14.907210+00:00" }, "document_number": { "value": "AB0000001", "created_at": "2026-08-26T09:51:21.629758+00:00", "updated_at": "2026-08-26T09:51:21.629782+00:00" }, "name_prefix": { "value": "Mr.", "created_at": "2026-08-26T09:51:21.663374+00:00", "updated_at": "2026-08-26T09:51:21.663393+00:00" }, "full_name_type": { "value": "parts", "created_at": "2026-08-26T09:51:21.738390+00:00", "updated_at": "2026-08-26T09:51:21.738409+00:00" }, "full_name_first_name": { "value": "Somchai", "created_at": "2026-08-26T09:51:21.684738+00:00", "updated_at": "2026-08-26T09:51:21.684753+00:00" }, "full_name_last_name": { "value": "Jaidee", "created_at": "2026-08-26T09:51:21.709491+00:00", "updated_at": "2026-08-26T09:51:21.709510+00:00" }, "full_name_en_first_name": { "value": "Somchai", "created_at": "2026-08-26T09:51:21.891338+00:00", "updated_at": "2026-08-26T09:51:21.891357+00:00" }, "full_name_en_last_name": { "value": "Jaidee", "created_at": "2026-08-26T09:51:21.912462+00:00", "updated_at": "2026-08-26T09:51:21.912479+00:00" }, "gender": { "value": "M", "created_at": "2026-08-26T09:51:21.870009+00:00", "updated_at": "2026-08-26T09:51:21.870026+00:00" }, "date_of_birth": { "value": "1996-08-16", "created_at": "2026-08-26T09:51:21.761786+00:00", "updated_at": "2026-08-26T09:51:21.761805+00:00" }, "date_of_issue": { "value": "2024-02-07", "created_at": "2026-08-26T09:51:21.783307+00:00", "updated_at": "2026-08-26T09:51:21.783321+00:00" }, "date_of_expiry": { "value": "2034-02-06", "created_at": "2026-08-26T09:51:21.802611+00:00", "updated_at": "2026-08-26T09:51:21.802629+00:00" }, "home_address_country": { "value": "THA", "created_at": "2026-08-26T09:51:21.847874+00:00", "updated_at": "2026-08-26T09:51:21.847893+00:00" } }}Every entry has the same shape
Section titled “Every entry has the same shape”| Field | Type | Req. | Notes |
|---|---|---|---|
value | string | number | boolean | yes | The captured value. Usually a string; boolean for checkboxes (for example
consent_checkbox_1). |
created_at | stringdate-time | When this field was first captured. | |
updated_at | stringdate-time | When this field was last written. Differs from created_at when the applicant
corrected a value or re-scanned the document. |
Read the value at answers.<key>.value. created_at and updated_at tell you when
that single field was captured, which is useful for auditing a re-scan.
The keys
Section titled “The keys”Presence varies by document type and flow configuration — noted per key below. Anything not noted appears on both National ID and passport submissions.
question_key |
Type | Meaning |
|---|---|---|
nid |
string | Thai national ID, 13 digits, check-digit validated. National ID submissions only. |
document_number |
string | Number printed on the document. |
ekyc_document_type |
enum | Document actually scanned: front_card (National ID) or passport. |
ekyc_document_country |
string | ISO 3166-1 alpha-3 issuing country. |
name_prefix |
string | Title. Not cross-validated against gender. |
gender |
enum | M or F. |
full_name_type |
enum | parts or full — whether the name arrives split or as one string. |
full_name_first_name |
string | Applicant-editable. Local script. |
full_name_middle_name |
string | Present only when supplied. |
full_name_last_name |
string | Applicant-editable. Local script. |
full_name_full |
string | Present only when full_name_type is full. |
full_name_en_first_name |
string | Read-only, from OCR. Latin script. |
full_name_en_last_name |
string | Read-only, from OCR. Latin script. |
date_of_birth |
date | ISO date. |
date_of_issue |
date | ISO date. |
date_of_expiry |
date | ISO date. Check against the submission date. |
home_address_country |
string | ISO 3166-1 alpha-3. Always present. |
home_address_address |
string | Street line (Thai address). |
home_address_subdistrict |
string | Khwaeng / tambon (Thai address). |
home_address_district |
string | Khet / amphoe (Thai address). |
home_address_province |
string | Province (Thai address). |
home_address_zipcode |
string | Postal code (Thai address). |
home_address_address_1_common |
string | Address line 1 (international address). |
home_address_address_2_common |
string | Address line 2 (international address). May be empty. |
home_address_city_common |
string | City (international address). |
home_address_postal_code_common |
string | Postal code (international address). |
home_address_full |
string | Derived single line. Absent on some submissions; may contain placeholder dashes. |
consent_version |
string | Consent text version. May be empty. |
consent_date |
date-time | Z suffix, unlike every other timestamp in the payload. |
consent_checkbox_1 |
boolean | Consent given. |
Input parameters you declared in Form → Builder → Input Parameter appear in this same object, in this same shape.
The two name pairs are not interchangeable
Section titled “The two name pairs are not interchangeable”This is the single most consequential detail on this page.
| Pair | Source | Editable by applicant |
|---|---|---|
full_name_first_name / full_name_last_name |
OCR, then editable | Yes |
full_name_en_first_name / full_name_en_last_name |
OCR | No |
Validation on the way in
Section titled “Validation on the way in”When you pre-fill a value, format rules apply even to a draft:
| Field | Rule |
|---|---|
nid |
^[0-9]{13}$ plus the Thai national-ID check digit |
document_number |
Required unless ekyc_document_country is THA and the document is a national ID |
date_of_birth / _issue / _expiry |
ISO date |
See Validation.