---
title: "Retrieve application status"
method: GET
path: "/onboarding/v1/applications/{onboardingId}/status"
tags: ["Onboarding"]
---

# Retrieve application status

`GET /onboarding/v1/applications/{onboardingId}/status`

## Request

- Base URL: `https://api.sandbox.bvnk.com`
- URL: `https://api.sandbox.bvnk.com/onboarding/v1/applications/{onboardingId}/status`
- Auth: API key in header `Authorization`
- TypeScript: <https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/docs/onboarding/v1/applications/:onboardingId/status/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves the current onboarding application state, including associates' validation status, outstanding required documents, questionnaire definitions, validation errors, and agreement statuses.

- Associate `validationStatus=INVALID` means outstanding requirements still exist; inspect `requiredDocuments`, `questionnaireDefinitions`, and `validationErrors`.
- On rejection, `rejectLabels` and `clientComment` describe why resubmission is required.

## Path parameters

- `onboardingId` string, uuid, required

## Response `200`

Current onboarding status and requirements

- OnboardingStatusResponse
  - `onboardingId` string, uuid, required
  - `status` 'NOT_STARTED' | 'IN_PROGRESS' | 'SUBMITTED' | 'REQUIRED_ACTIONS' | 'APPROVED' | 'REJECTED' | 'SUSPENDED', required: Application status.
  - `createdAt` string, date-time, required
  - `updatedAt` string, date-time, required
  - `associates` OnboardingStatusAssociate[], required
    - `id` string, uuid, required: Associate ID used for document upload and questionnaire submission.
    - `roles` string[], required: Roles assigned to the associate. At least one title is required. - `BUSINESS_OWNER`: Ultimate Beneficial Owner - `SIGNATORY`: authorised signatories, individuals officially empowered by an organization
    - `percentageOfOwnership` number, double
    - `validationStatus` 'VALID' | 'INVALID', required: Associate validation status. If the status is `INVALID`, check `requiredDocuments` and `validationErrors` for outstanding items.
    - `requiredDocuments` OnboardingRequiredDocument[], required: Array of the required document sets
      - `docSetType` string, required: Document set category.
      - `types` string[], required: Accepted document types for this set.
      - `status` 'NOT_SUBMITTED' | 'PENDING' | 'APPROVED' | 'REJECTED', required: Document status. - `NOT_SUBMITTED`: Document not yet uploaded. Action required. - `PENDING`: Document uploaded and queued for verification. - `APPROVED`: Document verified and accepted. - `REJECTED`: Document failed verification. Check `rejectLabels` and `clientComment` for reason. Resubmission required.
      - `rejectLabels` string[]
      - `clientComment` string
    - `questionnaireDefinitions` OnboardingQuestionnaireDefinition[], required: Questionnaires that must be completed for the associate. Includes field definitions, options, and validation rules.
      - `id` string, required: Questionnaire identifier used when submitting responses.
      - `title` string: Human-readable questionnaire title.
      - `sections` object, required: Questionnaire sections keyed by section ID.
    - `validationErrors` object[], required: Specific validation failures for the associate.
  - `agreements` OnboardingStatusAgreement[], required
    - `id` string, uuid, required
    - `name` string, required
    - `status` 'PENDING' | 'ACCEPTED' | 'DECLINED', required
    - `declinable` boolean, required

## Other responses

- `401`: Unauthorized
- `404`: The specified resource was not found

## Changes

- **2026-06-16** `97d6c0d2fe2e`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/onboarding/v1/applications/:onboardingId/status/get.md)

---

[API](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints.md) - [All operations](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/revisions/c386d436bf2c?raw)