Submit Application via Form

Submits a KYB application using flat form data structure. This endpoint is suitable for direct form submission or simple scenarios where all form fields are flattened without deep nesting. The server retrieves the questionnaire structure based on qnreIdentifierVersion and performs type conversion automatically.

Request

https://openapi.advance.ai/v1/business/applications/form
POST (application/json)

Request Header Parameters

Parameter	Description
Authorization	`string` Please use Token Authentication API to get your access token. Format: `Bearer {token}`

Request Parameters

Parameter	Required	Description
kybLevel	True	`string` The KYB verification level for this application.
applicantEmail	False	`string` The email address of the applicant. Must be a valid email format.
qnreIdentifierVersion	True	`string` The questionnaire identifier and version used to define the form structure. The server uses this to retrieve the questionnaire schema and perform type conversion.
subjectEntries	True	`array` List of form response items for the subject entity. Each item contains a question ID and its corresponding value.
declaredGroups	False	`array` List of declared entity groups (shareholders, directors, etc.). Each group contains multiple entries with their own form responses.

Request Parameters - Nested Objects

FormResponseItem

Field	Required	Description
questionId	True	`string` The unique identifier of the question in the questionnaire.
value	True	`any` The answer value for the question. The type depends on the question type defined in the questionnaire schema.

FormDeclaredGroupItem

Field	Required	Description
groupId	True	`string` The unique identifier of the declared group (e.g., shareholders group, directors group).
entries	True	`array` List of declared entry items within this group.

FormDeclaredEntryItem

Field	Required	Description
responses	False	`array` List of form response items for this declared entry.

Request Examples

curl -X POST "https://openapi.advance.ai/v1/business/applications/form" \
-H "Authorization: Bearer {Your Access Token}" \
-H "Content-Type: application/json" \
-d '{
  "kybLevel": "STANDARD",
  "applicantEmail": "[email protected]",
  "qnreIdentifierVersion": "kyb-standard-v1.0",
  "subjectEntries": [
    {
      "questionId": "company_name",
      "value": "Example Corp Ltd"
    },
    {
      "questionId": "registration_number",
      "value": "123456789"
    },
    {
      "questionId": "registered_country",
      "value": "SGP"
    }
  ],
  "declaredGroups": [
    {
      "groupId": "shareholders",
      "entries": [
        {
          "responses": [
            {
              "questionId": "shareholder_name",
              "value": "John Smith"
            },
            {
              "questionId": "share_ratio",
              "value": 25.5
            }
          ]
        }
      ]
    }
  ]
}'

Success Response

Response Description

Field	Description
applicationId	`string` The unique identifier of the created KYB application.
status	`enum` The current status of the application.
subjectCompany	`object` The subject company information.
declaredCompanies	`array` List of declared company entities.
declaredIndividuals	`array` List of declared individual entities.

Response.status

KYB Application Status

Value	Description
PENDING_REVIEW	Application requires manual review.
PENDING_RESUBMISSION	Application requires resubmission with corrections.
APPROVED	Application has been approved.
REJECTED	Application has been rejected.

Response.subjectCompany

Field	Description
companyId	`string` The unique company identifier.
externalId	`string` External identifier provided by the client.
companyName	`string` The registered name of the company.
registrationNumber	`string` The company registration number.
registeredCountry	`string` The country where the company is registered (ISO 3166-1 alpha-3).
registrationDate	`string` The registration date in ISO 8601 format.
legalType	`enum` The legal entity type of the company.
legalAddress	`string` The registered legal address.
email	`string` The company email address.
phone	`string` The company phone number.
taxId	`string` The tax identification number.
leiCode	`string` The Legal Entity Identifier code.
websiteUrl	`string` The company website URL.
confirmed	`boolean` Whether the company architecture is confirmed.
customFields	`array` List of custom field values.
attachedDocs	`array` List of attached document identifiers.
createdAt	`string` The creation timestamp in ISO 8601 format.
updatedAt	`string` The last update timestamp in ISO 8601 format.

Response.declaredCompanies[]

Field	Description
companyId	`string` The unique company identifier.
externalId	`string` External identifier provided by the client.
companyName	`string` The registered name of the company.
roleType	`enum` The role type of this company in relation to the subject.
shareRatio	`number` The ownership share ratio (percentage).
registrationNumber	`string` The company registration number.
registeredCountry	`string` The country where the company is registered.
registrationDate	`string` The registration date in ISO 8601 format.
legalType	`enum` The legal entity type of the company.
legalAddress	`string` The registered legal address.
email	`string` The company email address.
phone	`string` The company phone number.
taxId	`string` The tax identification number.
leiCode	`string` The Legal Entity Identifier code.
websiteUrl	`string` The company website URL.
confirmed	`boolean` Whether the company architecture is confirmed.
customFields	`array` List of custom field values.
attachedDocs	`array` List of attached document identifiers.
createdAt	`string` The creation timestamp in ISO 8601 format.
updatedAt	`string` The last update timestamp in ISO 8601 format.

Response.declaredIndividuals[]

Field	Description
individualId	`string` The unique individual identifier.
externalId	`string` External identifier provided by the client.
firstName	`string` The first name of the individual.
middleName	`string` The middle name of the individual.
lastName	`string` The last name of the individual.
legalName	`string` The legal name of the individual.
aliasName	`string` Any alias name used by the individual.
roleType	`enum` The role type of this individual in the company.
individualType	`enum` The type of individual (SHAREHOLDER or OFFICER).
shareRatio	`number` The ownership share ratio (percentage).
companyId	`string` The associated company identifier.
gender	`enum` The gender of the individual (MALE, FEMALE, OTHER).
dob	`string` The date of birth in ISO 8601 format.
placeOfBirth	`string` The place of birth.
countryOfResidence	`string` The country of residence.
nationality	`string` The nationality.
tin	`string` The Tax Identification Number.
taxResidenceCountry	`string` The country of tax residence.
email	`string` The email address.
confirmed	`boolean` Whether the individual information is confirmed.
customFields	`array` List of custom field values.
attachedDocs	`array` List of attached document identifiers.
createdAt	`string` The creation timestamp in ISO 8601 format.
updatedAt	`string` The last update timestamp in ISO 8601 format.

Enumerations

CompanyRoleTypeEnum

Value	Description
UBO	Ultimate Beneficial Owner
SHAREHOLDER	Shareholder
REPRESENTATIVE	Representative
DIRECTOR	Director
AUTHORIZED_PERSON	Authorized Person
OTHER	Other
ACCOUNTANT	Accountant
COMMISSIONER	Commissioner
AUDITOR	Auditor
SECRETARY	Secretary

CompanyLegalTypeEnum

Value	Description
PRIVATE_LIMITED_LIABILITY_COMPANY	Private Limited Liability Company
PUBLIC_LIMITED_LIABILITY_COMPANY	Public Limited Liability Company
LIMITED_LIABILITY_COMPANY	Limited Liability Company
FOUNDATION	Foundation
ASSOCIATION	Association
COOPERATIVE	Cooperative
LIMITED_PARTNERSHIP	Limited Partnership
SOLE_PROPRIETORSHIP	Sole Proprietorship
FEDERATION_OF_FIRMS	Federation of Firms
CIVIL_PARTNERSHIP	Civil Partnership
GENERAL_PARTNERSHIP	General Partnership
PUBLIC_UTILITY_COMPANY	Public Utility Company
STATE_OWNED_COMPANY	State-owned Company
COMPANY_LIMITED_BY_GUARANTEE	Company Limited by Guarantee
SOCIETY	Society
NON_PROFIT_ORGANIZATION	Non-Profit Organization
BRANCH_OFFICE	Branch Office
LIMITED_LIABILITY_PARTNERSHIP	Limited Liability Partnership
TRUST	Trust
GOVERNMENT_ENTITY	Government Entity
OTHERS	Others

KybIndividualTypeEnum

Value	Description
SHAREHOLDER	Individual is a shareholder.
OFFICER	Individual is an officer (director, representative, etc.).

Response Examples

{
  "applicationId": "APP-2026052200001",
  "status": "PENDING_REVIEW",
  "subjectCompany": {
    "companyId": "COM-2026052200001",
    "externalId": null,
    "companyName": "Example Corp Ltd",
    "registrationNumber": "123456789",
    "registeredCountry": "SGP",
    "registrationDate": "2020-01-15",
    "legalType": "PRIVATE_LIMITED_LIABILITY_COMPANY",
    "legalAddress": "123 Business Street, Singapore 123456",
    "email": "[email protected]",
    "phone": "+65 1234 5678",
    "taxId": "T12345678A",
    "leiCode": null,
    "websiteUrl": "https://example.com",
    "confirmed": false,
    "customFields": [],
    "attachedDocs": [],
    "createdAt": "2026-05-22T10:30:00Z",
    "updatedAt": "2026-05-22T10:30:00Z"
  },
  "declaredCompanies": [],
  "declaredIndividuals": [
    {
      "individualId": "IND-2026052200001",
      "externalId": null,
      "firstName": "John",
      "middleName": null,
      "lastName": "Smith",
      "legalName": "John Smith",
      "aliasName": null,
      "roleType": "SHAREHOLDER",
      "individualType": "SHAREHOLDER",
      "shareRatio": 25.5,
      "companyId": "COM-2026052200001",
      "gender": "MALE",
      "dob": "1985-03-20",
      "placeOfBirth": "Singapore",
      "countryOfResidence": "SGP",
      "nationality": "SGP",
      "tin": null,
      "taxResidenceCountry": "SGP",
      "email": "[email protected]",
      "confirmed": false,
      "customFields": [],
      "attachedDocs": [],
      "createdAt": "2026-05-22T10:30:00Z",
      "updatedAt": "2026-05-22T10:30:00Z"
    }
  ]
}

Error Response

Response Description

The standard error response object.

Parameter	Description
error	`object` The error details.

ResponseError.error

Field	Description
type	`string` Error code or type.
message	`string` Human-readable error message.

ResponseError.error.type

Value	Description	HTTP Status Code
parameter_error	Parameter validation failed (e.g., missing or invalid parameter).	400 Bad Request
iam_failed	Authentication or authorization failed.	401 Unauthorized
error	Internal server error or unknown error.	500 Internal Server Error
not_found	Requested resource not found.	404 Not Found
service_busy	The service is busy or rate limited.	429 Too Many Requests

Response Examples

{
  "error": {
    "type": "parameter_error",
    "message": "kybLevel cannot be empty"
  }
}

Updated about 11 hours ago