---
title: LegalEntities
editUrl: false
head: []
template: doc
prev: false
next: false
sidebar:
  hidden: false
  attrs: {}
pagefind: true
draft: false
---

Defined in: [src/team/client.gen.ts:286](https://github.com/slingshot/brex/blob/9dff46b5d5637a0dd072bca56d02d8a0f4425312/src/team/client.gen.ts#L286)

## Constructors

### Constructor

> **new LegalEntities**(`_core`): `LegalEntities`

Defined in: [src/team/client.gen.ts:287](https://github.com/slingshot/brex/blob/9dff46b5d5637a0dd072bca56d02d8a0f4425312/src/team/client.gen.ts#L287)

#### Parameters

##### \_core

[`BrexCore`](/brex/api/index/classes/brexcore/)

#### Returns

`LegalEntities`

## Methods

### get()

> **get**(`id`, `options?`): `Promise`\<\{ `billingAddress`: \{ `city?`: `string` \| `null`; `country?`: `string` \| `null`; `line1?`: `string` \| `null`; `line2?`: `string` \| `null`; `phone_number?`: `string` \| `null`; `postal_code?`: `string` \| `null`; `state?`: `string` \| `null`; \}; `createdAt`: `string`; `displayName`: `string`; `id`: `string`; `isDefault?`: `boolean`; `status`: `"UNSUBMITTED"` \| `"UNVERIFIED"` \| `"IN_PROGRESS"` \| `"VERIFIED"` \| `"REJECTED"`; \}\>

Defined in: [src/team/client.gen.ts:296](https://github.com/slingshot/brex/blob/9dff46b5d5637a0dd072bca56d02d8a0f4425312/src/team/client.gen.ts#L296)

Get legal entity

Get a legal entity by its ID.

`GET /v2/legal_entities/{id}` — requires OAuth scope: `legal_entities`, `legal_entities.readonly`

#### Parameters

##### id

`string`

##### options?

[`RequestOptions`](/brex/api/index/interfaces/requestoptions/)

#### Returns

`Promise`\<\{ `billingAddress`: \{ `city?`: `string` \| `null`; `country?`: `string` \| `null`; `line1?`: `string` \| `null`; `line2?`: `string` \| `null`; `phone_number?`: `string` \| `null`; `postal_code?`: `string` \| `null`; `state?`: `string` \| `null`; \}; `createdAt`: `string`; `displayName`: `string`; `id`: `string`; `isDefault?`: `boolean`; `status`: `"UNSUBMITTED"` \| `"UNVERIFIED"` \| `"IN_PROGRESS"` \| `"VERIFIED"` \| `"REJECTED"`; \}\>

***

### list()

> **list**(`query?`, `options?`): [`PagePromise`](/brex/api/index/classes/pagepromise/)\<\{ `items`: `object`[]; `next_cursor?`: `string` \| `null`; \}\>

Defined in: [src/team/client.gen.ts:315](https://github.com/slingshot/brex/blob/9dff46b5d5637a0dd072bca56d02d8a0f4425312/src/team/client.gen.ts#L315)

List legal entities

List legal entities for the account.

`GET /v2/legal_entities` — requires OAuth scope: `legal_entities`, `legal_entities.readonly`
Await for a single page, or `for await` to iterate items across all pages.

#### Parameters

##### query?

###### cursor?

`string` \| `null`

###### limit?

`number` \| `null`

##### options?

[`RequestOptions`](/brex/api/index/interfaces/requestoptions/)

#### Returns

[`PagePromise`](/brex/api/index/classes/pagepromise/)\<\{ `items`: `object`[]; `next_cursor?`: `string` \| `null`; \}\>