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

# Get Account Checks

`GET /accounts/{account_id}/checks`

## Path parameters

- `account_id` string, required

## Query parameters

- `cursor` string
- `limit` integer

## 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', required — A category describing the type of an onboarding 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> </ul>
    - `category` 'onboarding' | 'post_onboarding', 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

---

[API](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api.md) · [All operations](https://skmtc.net/lemon/apis/lemon-markets-brokerage-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lemon/lemon-markets-brokerage-api/revisions/3c8cfd3a96c9/schema)