---
title: "List all legal entities"
method: GET
path: "/open-api/v3/business/account/{accountId}/legal-entity"
tags: ["Account Onboarding"]
---

# List all legal entities

`GET /open-api/v3/business/account/{accountId}/legal-entity`

## Request

- Base URL: `https://api-sandbox.interlace.money`
- URL: `https://api-sandbox.interlace.money/open-api/v3/business/account/{accountId}/legal-entity`
- Auth: API key in header `x-access-token`

Retrieves a list of all legal entities, optionally supporting pagination

## Path parameters

- `accountId` string, required

## Query parameters

- `idNumber` string: IdNo / Business Number etc.
- `limit` string, number: Limits the number of items to be returned.
- `page` string, number: The page to be returned, counting from 1 as the first page.

## Response `200`

OK

- LegalEntityPageRespDTO
  - `code` string: Error code
  - `message` string: Error message
  - `data` LegalEntityPage, required: Data
    - `total` integer, required: total number
    - `list` CreateLegalEntitiesRespDTO[], required: Data list
      - `parentAccountId` string: The parent account ID of the specified account.
      - `accountId` string: The UUID of the Account.
      - `accountName` string: Account Name
      - `id` string: Unique ID generated for the entity.
      - `idNumber` string: IdNo / Business Number etc.
      - `createTime` string: create time, millisecond timestamp
      - `status` 'PENDING' | 'PROCESSING' | 'AWAIT_ADDITIONAL' | 'REVIEW_ADDITIONAL' | 'REQUEST' | 'FROZEN' | 'FAILED' | 'DELETED' | 'INACTIVE' | 'ACTIVE': Status of the legal entity onboarding process: - **PENDING** — The application has been submitted and is awaiting processing. - **PROCESSING** — The application is under review or verification. - **AWAIT_ADDITIONAL** — Additional information or documents are required from the applicant. - **REVIEW_ADDITIONAL** — The additional documents submitted are being reviewed. - **REQUEST** — The entity has requested activation or modification. - **FROZEN** — The account or entity has been temporarily frozen due to compliance or risk reasons. - **FAILED** — The onboarding or verification process failed. - **DELETED** — The entity record has been deleted or permanently deactivated. - **INACTIVE** — The entity or account exists but is not yet active. - **ACTIVE** — The entity or account is fully active and operational.

## Other responses

- `400`: Bad Request

---

[API](https://skmtc.dev/interlace/apis/business-account.md) - [All operations](https://skmtc.dev/interlace/apis/business-account/llms.txt) - [OpenAPI document](https://skmtc.dev/interlace/apis/business-account/revisions/dd6b30aaac4f?raw)