---
title: "List consented legal entities"
method: GET
path: "/api/v1/me/legal-entities"
tags: ["Consented legal entities"]
---

# List consented legal entities

`GET /api/v1/me/legal-entities`

## Request

- Base URL: `https://portal.eprospera.com`
- URL: `https://portal.eprospera.com/api/v1/me/legal-entities`
- Auth: OAuth 2
  - Authorization code: `https://portal.eprospera.com/api/oauth/authorize`
  - Token URL: `https://portal.eprospera.com/api/oauth/token` scopes: `eprospera:entity.read`
- TypeScript: <https://skmtc.dev/eprospera/apis/e-pro-spera-api/docs/api/v1/me/legal-entities/get.ts> (a function with typed inputs; its response is checked against the schema)

Account deactivation revokes personal API keys, including Agent Keys, and OAuth authorizations. Account reactivation requires new API keys, including new Agent Keys, and consent; previously issued credentials remain invalid.

## Response `200`

Consented entities.

- object: Successful response.
  - `data` LegalEntity[], required
    - `id` string, uuid, required
    - `optionId` string, required
    - `type` string, required
    - `name` string, required
    - `extension` string, required
    - `nameStartsWithExtension` boolean, required
    - `formationDate` string, nullable: Formation date as YYYY-MM-DD.
    - `registrationDate` string, date-time, nullable
    - `dissolutionDate` string, date-time, nullable
    - `residentPermitNumber` string, nullable, required: 14-digit Resident Permit Number.
    - `principalOfficeAddress` Address, nullable
      - `line1` string, required
      - `line2` string, nullable
      - `city` string, required
      - `state` string, nullable
      - `postalCode` string, required
      - `country` string, required
    - `createdAt` string, date-time

## Other responses

- `400`: Validation error or precondition failure.
- `401`: Missing or invalid credential.
- `403`: Credential lacks the required scope (Agent Key) or insufficient OAuth scope.
- `404`: Resource does not exist or is invisible to the caller. The two are intentionally indistinguishable.
- `409`: Conflicting state (e.g. legal-entity name already taken).
- `429`: Rate limit exceeded. No `Retry-After` header is currently emitted; back off exponentially.
- `500`: Server error.

## Changes

- **2026-10-05** `4e7a4c475288`: 1 breaking
  - the `data/items/formationDate` response's property format changed from `date-time` to no format for status `200`
- **2026-09-22** `d2c5a5cda002`: 7 info
  - added the optional property `code` to the response with the `400` status
  - added the optional property `code` to the response with the `401` status
  - added the optional property `code` to the response with the `403` status
  - added the optional property `code` to the response with the `404` status
  - …3 more

[Operation history](https://skmtc.dev/eprospera/apis/e-pro-spera-api/changes/api/v1/me/legal-entities/get.md)

---

[API](https://skmtc.dev/eprospera/apis/e-pro-spera-api.md) - [All operations](https://skmtc.dev/eprospera/apis/e-pro-spera-api/llms.txt) - [OpenAPI document](https://skmtc.dev/eprospera/apis/e-pro-spera-api/revisions/271098460337?raw)