Get Application Risk Checks

Retrieves the list of risk checks performed for a specific KYB application. Each risk check represents a verification process such as AML screening, ID verification, business registry verification, etc.

Request

https://openapi.advance.ai/v1/business/applications/{applicationId}/checks
GET

Request Header Parameters

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

Path Parameters

Parameter	Required	Description
applicationId	True	`string` The unique identifier of the application.

Request Examples

curl -X GET "https://openapi.advance.ai/v1/business/applications/APP-2026052200001/checks" \
-H "Authorization: Bearer {Your Access Token}"

Success Response

Response Description

Field	Description
applicationId	`string` The unique identifier of the application.
applicationStatus	`enum` The current status of the application.
riskChecks	`array` List of risk check objects.

Response.riskChecks[]

RiskCheck Object

Field	Description
profileId	`string` The profile identifier associated with this check.
sessionId	`string` The session identifier for this check.
entityType	`enum` The type of entity being checked (COMPANY or INDIVIDUAL).
checkType	`enum` The type of risk check performed.
status	`enum` The current status of the check.
errorMessage	`string` Error message if the check failed.
createdAt	`string` The creation timestamp in ISO 8601 format.
updatedAt	`string` The last update timestamp in ISO 8601 format.
endedAt	`string` The completion timestamp in ISO 8601 format.

Enumerations

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.

EntityTypeEnum

Value	Description
COMPANY	The entity is a company.
INDIVIDUAL	The entity is an individual.

KybCheckingItemEnum (Check Types)

Value	Description
AML	AML (Anti-Money Laundering) Checks - Screens against sanctions, PEP, and adverse media lists.
IDV	ID Verification - Verifies the identity of individuals.
REGISTRY_BASIC	Basic Business Verification - Basic existence check against registries.
REGISTRY_STANDARD	Standard Business Verification - Standard verification with company details.
REGISTRY_ENHANCED	Enhanced Business Verification - Comprehensive verification with full company profile.
REGISTRY_BO	Beneficial Owner Verification - Verifies beneficial ownership structure.
CHARITY	Charity Checking - Verifies charity registration status.
SOCIETY	Society Checking - Verifies society registration status.
MASTER_CARD	MasterCard Termination Inquiry - Checks against MasterCard MATCH list.
VISA_CARD	Visa Card Termination Inquiry - Checks against Visa TMF list.

KybCheckingStatusEnum (Check Status)

Value	Description
OPEN	Check has been created but not started.
IN_PROGRESS	Check is currently being processed.
PENDING_REVIEW	Check requires manual review.
EXPIRED	Check has expired.
ERROR	Check encountered an error.
FAIL	Check failed.
INCOMPLETE	Check is incomplete.
COMPLETED	Check has been completed.
APPROVED	Check has been approved.
HIT	Check found a match (e.g., AML hit).
NO_HIT	Check found no match.
SUCCESS	Check was successful.
PASS	Check passed.
REJECTED	Check was rejected.

Response Examples

{
  "applicationId": "APP-2026052200001",
  "applicationStatus": "PENDING_REVIEW",
  "riskChecks": [
    {
      "profileId": "PROF-001",
      "sessionId": "SESS-001",
      "entityType": "COMPANY",
      "checkType": "REGISTRY_STANDARD",
      "status": "COMPLETED",
      "errorMessage": null,
      "createdAt": "2026-05-22T10:30:00Z",
      "updatedAt": "2026-05-22T10:35:00Z",
      "endedAt": "2026-05-22T10:35:00Z"
    },
    {
      "profileId": "PROF-001",
      "sessionId": "SESS-002",
      "entityType": "COMPANY",
      "checkType": "AML",
      "status": "NO_HIT",
      "errorMessage": null,
      "createdAt": "2026-05-22T10:30:00Z",
      "updatedAt": "2026-05-22T10:32:00Z",
      "endedAt": "2026-05-22T10:32:00Z"
    },
    {
      "profileId": "PROF-002",
      "sessionId": "SESS-003",
      "entityType": "INDIVIDUAL",
      "checkType": "AML",
      "status": "HIT",
      "errorMessage": null,
      "createdAt": "2026-05-22T10:30:00Z",
      "updatedAt": "2026-05-22T10:33:00Z",
      "endedAt": "2026-05-22T10:33:00Z"
    },
    {
      "profileId": "PROF-002",
      "sessionId": "SESS-004",
      "entityType": "INDIVIDUAL",
      "checkType": "IDV",
      "status": "IN_PROGRESS",
      "errorMessage": null,
      "createdAt": "2026-05-22T10:30:00Z",
      "updatedAt": "2026-05-22T10:30:00Z",
      "endedAt": null
    }
  ]
}

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": "not_found",
    "message": "Application not found"
  }
}

Updated about 11 hours ago