---
title: "List legal entities"
method: GET
path: "/v2/legal_entities"
tags: ["Legal Entities"]
---

# List legal entities

`GET /v2/legal_entities`

List legal entities for the account.

## Query parameters

- `cursor` string, nullable
- `limit` integer, nullable

## Response `200`

listLegalEntities 200 response

- PageLegalEntity
  - `next_cursor` string, nullable
  - `items` LegalEntity[], required
    - `id` string, required — The ID of this legal entity.
    - `displayName` string, required — The display name of this legal entity.
    - `billingAddress` object, required — The billing address of this legal entity. Also used as billing address for cards issued to users who belong to this entity.
      - `line1` string, nullable — Address line 1, no PO Box.
      - `line2` string, nullable — Address line 2 (e.g., apartment, suite, unit, or building).
      - `city` string, nullable — City, district, suburb, town, or village.
      - `state` string, nullable — For US-addressed the 2-letter State abbreviation. For international-addresses the county, providence, or region.
      - `country` string, nullable — Two-letter country code (ISO 3166-1 alpha-2).
      - `postal_code` string, nullable — ZIP or postal code.
      - `phone_number` string, nullable — Phone number.
    - `createdAt` string, date-time, required — Timestamp, in UTC, when this legal entity was created.
    - `status` 'UNSUBMITTED' | 'UNVERIFIED' | 'IN_PROGRESS' | 'VERIFIED' | 'REJECTED', required — The current status of this legal entity.
    - `isDefault` boolean — Whether this is the default entity of the account.

---

[API](https://skmtc.net/brex-com/apis/team-api.md) · [All operations](https://skmtc.net/brex-com/apis/team-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/brex-com/team-api/revisions/58e231ca118e/schema)