---
title: "Get Account Checks"
method: GET
path: "/accounts/{account_id}/checks"
tags: ["Accounts: General"]
---

# Get Account Checks

`GET /accounts/{account_id}/checks`

## Request

- Base URL: `https://sandbox.api.lemon.markets/v1`
- URL: `https://sandbox.api.lemon.markets/v1/accounts/{account_id}/checks`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/docs/accounts/:account_id/checks/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `account_id` string, required

## Query parameters

- `cursor` string
- `limit` integer
- `category` 'onboarding' | 'post_onboarding' | 'offboarding'

## Headers

- `LMG-Data-Privacy-Access-Principal` string, required
- `LMG-Data-Privacy-Access-Justification` string, required

## Response `200`

Successful Response

- PageCustomerAccountCheckResponse
  - `data` CustomerAccountCheckResponse[], required: The elements of the response.
    - `type` 'address_validation' | 'authenticator_enrollment' | 'authenticator_reset' | 'identity_verification' | 'risk_assessment' | 'submit_document' | 'tin_validation' | 'positions' | 'cash_balance' | 'overdue_fees', required: The type of an account check: <ul> <li><code>address_validation</code> <li><code>authenticator_enrollment</code> <li><code>authenticator_reset</code> <li><code>identity_verification</code> <li><code>risk_assessment</code> <li><code>submit_document</code> <li><code>tin_validation</code> <li><code>positions</code>: sell all open positions before the account can be closed. <li><code>cash_balance</code>: withdraw remaining cash balance before the account can be closed. <li><code>overdue_fees</code>: settle overdue fees before the account can be closed. </ul>
    - `category` 'onboarding' | 'post_onboarding' | 'offboarding', required
    - `status` 'action_required' | 'processing' | 'success' | 'failure', required: A category describing the status of an account check: <ul> <li><code>action_required</code>: An action is required to move forward with this check. <li><code>processing</code>: This check is in progress. <li><code>success</code>: This check was completed. <li><code>failure</code>: This check has failed. </ul>
    - `actions` Action[], required
      - union: An object representing an action that either needs to be performed or that needed to be performed in the past.
        - CompleteIdentificationAction: An action to indicate that identification information needs to be uploaded.
          - `type` 'complete_identification', required: The string `"complete_identification"`, identifiying this type of action.
          - `identification` string, required: The identifier for the identification process to be completed.
          - `person` string, required: The identifier for the person that needs to complete the identification process.
        - EnrollSCAAuthenticatorAction: An object representing the requirement to enroll an authenticator fro storng customer authentication (SCA).
          - `type` 'enroll_sca_authenticator', required: A type value indicating the type of action: `enroll_sca_authenticator`
        - InitiateIdentityVerificationAction: An object representing the requirement to perform identity verification.
          - `type` 'initiate_identity_verification', required: A type value indicating the type of action: `initiate_identity_verification`
          - `url` string: The address of the website to visit for performing the identity verification.
          - `video_ident_id` string: The identifier for the video identification process.
        - PendingCheckAction: An object representing the requirement for proof of address.
          - `type` 'proof_of_address' | 'tax_identification', required: A type value indicating the type of action: <ul> <li><code>proof_of_address</code> <li><code>tax_identification</code> </ul>
          - `due_date` string, date, required: The date by which this action has to be completed to avoid limitations on account capabilities.
        - ProvideSCARecoveryCodeAction: This action indicates the requirement for a user to reset their authenticator using the recovery code provided by lemon.markets.
          - `type` 'provide_recovery_code', required: A type value indicating the type of action: `provide_recovery_code`
          - `expires_at` string, date-time: Expiry date. Provide the recovery code when setting up a new authenticator before this date. After this point in time, the recovery code will be considered expired.
        - SubmitDocumentAction
          - `type` 'submit_document', required
          - `document` 'articles_of_association' | 'commercial_register_extract' | 'shareholder_list', required: A category describing the a business document: <ul> <li><code>articles_of_association</code> <li><code>commercial_register_extract</code> <li><code>shareholder_list</code> </ul>
    - `history` StatusChangeOnboardingCheckStatus[], required: A history of the status changes for an account check.
      - `status` 'action_required' | 'processing' | 'success' | 'failure', required: A category describing the status of an account check: <ul> <li><code>action_required</code>: An action is required to move forward with this check. <li><code>processing</code>: This check is in progress. <li><code>success</code>: This check was completed. <li><code>failure</code>: This check has failed. </ul>
      - `timestamp` string, date-time, required: The timestamp of the event. It represents the point in time at which the account check was updated.
  - `pagination` Pagination, required: Information about accessing elements beyond the ones that were returned.
    - `next_cursor` string: When fetching long lists of elements, you can use our pagination feature to fetch batches of data. If a response contains the property `pagination.next_cursor`, you can pass its value via the query item `cursor` to generate the request for the next batch of data.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `404`: Not Found
- `422`: Unprocessable Entity
- `5XX`: Server Error

## Changes

- **2026-11-03** `1f1df208c0e4`: 4 warning, 1 info
  - added the new `cash_balance` enum value to the `data/items/type` response property for the response status `200`
  - added the new `offboarding` enum value to the `data/items/category` response property for the response status `200`
  - added the new `overdue_fees` enum value to the `data/items/type` response property for the response status `200`
  - added the new `positions` enum value to the `data/items/type` response property for the response status `200`
  - …1 more

[Operation history](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/changes/accounts/:account_id/checks/get.md)

---

[API](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api.md) - [All operations](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lemon/apis/lemon-markets-brokerage-api/revisions/1f1df208c0e4?raw)