List Applications

Retrieves a paginated list of KYB applications. Supports filtering by application IDs, status, and creation time range.

Request

https://openapi.advance.ai/v1/business/applications/page
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
current	False	`integer` Current page number. Defaults to 1.
size	False	`integer` Number of records per page. Defaults to 10. Maximum 100.
applicationIds	False	`array` List of application IDs to filter. Maximum 100 items.
status	False	`enum` Filter by application status. See KybApplicationStatusEnum.
createdFrom	False	`string` Filter applications created from this time (ISO 8601 format).
createdTo	False	`string` Filter applications created until this time (ISO 8601 format).

KybApplicationStatusEnum

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.

Request Examples

curl -X POST "https://openapi.advance.ai/v1/business/applications/page" \
-H "Authorization: Bearer {Your Access Token}" \
-H "Content-Type: application/json" \
-d '{
  "current": 1,
  "size": 20
}'

curl -X POST "https://openapi.advance.ai/v1/business/applications/page" \
-H "Authorization: Bearer {Your Access Token}" \
-H "Content-Type: application/json" \
-d '{
  "current": 1,
  "size": 20,
  "status": "PENDING_REVIEW"
}'

curl -X POST "https://openapi.advance.ai/v1/business/applications/page" \
-H "Authorization: Bearer {Your Access Token}" \
-H "Content-Type: application/json" \
-d '{
  "current": 1,
  "size": 20,
  "createdFrom": "2026-01-01T00:00:00Z",
  "createdTo": "2026-05-22T23:59:59Z"
}'

curl -X POST "https://openapi.advance.ai/v1/business/applications/page" \
-H "Authorization: Bearer {Your Access Token}" \
-H "Content-Type: application/json" \
-d '{
  "applicationIds": ["APP-001", "APP-002", "APP-003"]
}'

Success Response

Response Description

Returns a paginated response with the following structure:

Field	Description
records	`array` List of application records.
total	`integer` Total number of records matching the query.
size	`integer` Number of records per page.
current	`integer` Current page number.
pages	`integer` Total number of pages.

Response.records[]

Application Record Object

Field	Description
applicationId	`string` The unique identifier of the application.
companyName	`string` The name of the subject company.
externalId	`string` External identifier provided by the client.
profileId	`string` The profile identifier.
applicationStatus	`enum` The current status of the application.
submittedAt	`string` The submission timestamp in ISO 8601 format.
createdAt	`string` The creation timestamp in ISO 8601 format.
updatedAt	`string` The last update timestamp in ISO 8601 format.

Response Examples

{
  "records": [
    {
      "applicationId": "APP-2026052200001",
      "companyName": "Example Corp Ltd",
      "externalId": "EXT-12345",
      "profileId": "PROF-001",
      "applicationStatus": "PENDING_REVIEW",
      "submittedAt": "2026-05-22T10:30:00Z",
      "createdAt": "2026-05-22T10:30:00Z",
      "updatedAt": "2026-05-22T10:35:00Z"
    },
    {
      "applicationId": "APP-2026052200002",
      "companyName": "Another Company Pte Ltd",
      "externalId": null,
      "profileId": "PROF-002",
      "applicationStatus": "APPROVED",
      "submittedAt": "2026-05-21T14:20:00Z",
      "createdAt": "2026-05-21T14:20:00Z",
      "updatedAt": "2026-05-22T09:15:00Z"
    }
  ],
  "total": 50,
  "size": 20,
  "current": 1,
  "pages": 3
}

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": "applicationIds size cannot exceed 100"
  }
}

Updated about 11 hours ago