---
title: "Get a consented legal entity"
method: GET
path: "/api/v1/me/legal-entities/{id}"
tags: ["Consented legal entities"]
---

# Get a consented legal entity

`GET /api/v1/me/legal-entities/{id}`

## Request

- Base URL: `https://portal.eprospera.com`
- URL: `https://portal.eprospera.com/api/v1/me/legal-entities/{id}`
- 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/:id/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.

## Path parameters

- `id` string, uuid, required

## Response `200`

Consented legal entity.

- object: Successful response.
  - `data` LegalEntityDetails, 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
    - `jurisdictionOfFormation` string, required
    - `status` 'active' | 'inactive' | 'dissolved', required: Dissolved when the dissolution date has passed; otherwise active when residency is current, or inactive. This is not a certificate of good standing.
    - `residencyStatus` 'active' | 'inactive', required
    - `residency` object, nullable, required
      - `type` string, required
      - `effectiveDate` string, date-time, required
      - `terminationDate` string, date-time, nullable, required
    - `registeredAddress` object, nullable, required: Current registered agent office address; distinct from principalOfficeAddress.
      - `line1` string, required
      - `line2` string, nullable
      - `city` string, required
      - `state` string, nullable
      - `postalCode` string, required
      - `country` string, required
    - `registeredAgent` object, nullable, required
      - `providerId` string, required
      - `name` string, nullable, required
      - `attn` string, nullable, required
      - `website` string, nullable, required
      - `residentPermitNumber` string, nullable, required: 14-digit Resident Permit Number.
      - `effectiveDate` string, date-time, required
      - `terminationDate` string, date-time, nullable, required
      - `officeAddress` Address, nullable, required
        - `line1` string, required
        - `line2` string, nullable
        - `city` string, required
        - `state` string, nullable
        - `postalCode` string, required
        - `country` string, required
      - `mailingAddress` Address, nullable, required
        - `line1` string, required
        - `line2` string, nullable
        - `city` string, required
        - `state` string, nullable
        - `postalCode` string, required
        - `country` string, required

## 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`: 8 breaking, 5 warning, 1 info
  - the `data` response's property type changed from `object` to no type for status `200`
  - removed the required property `data/extension` from the response with the `200` status
  - removed the required property `data/id` from the response with the `200` status
  - removed the required property `data/name` from the response with the `200` status
  - …10 more
- **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/:id/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)