GET legal_entities/[id]

Retrieve details of a specific legal entity that you represent.

Endpoint

GET /api/v1/legal_entities/{id}

Authentication

Requires a valid API key in the Authorization header:

Authorization: Bearer <your-api-key>

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	The unique identifier of the legal entity

Example Request

curl -X GET https://portal.eprospera.com/api/v1/legal_entities/123e4567-e89b-12d3-a456-426614174000 \
  -H "Authorization: Bearer <your-api-key>"

Response

Success Response (200 OK)

Field	Type	Description
data	object	Legal entity details

Data Object Fields

Field	Type	Description
id	string	Legal entity unique identifier
optionId	string	Entity option identifier
type	string	Type of legal entity
name	string	Legal entity name
extension	string	Legal entity extension (e.g., "LLC")
nameStartsWithExtension	boolean	Whether name starts with the extension
formationDate	string	Date of formation (ISO 8601)
registrationDate	string	Date of registration (ISO 8601)
dissolutionDate	string | null	Date of dissolution if applicable
createdAt	string	Creation timestamp (ISO 8601)
principalOfficeAddress	object	Principal office address details
residentPermitNumber	string	Associated resident permit number

Principal Office Address Fields

Field	Type	Description
line1	string	Address line 1
line2	string | null	Address line 2
city	string	City
state	string | null	State/province
postalCode	string	Postal code
country	string	Country

Example Response

{
  "data": {
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "optionId": "llc",
    "type": "LLC",
    "name": "Example Company",
    "extension": "LLC",
    "nameStartsWithExtension": false,
    "formationDate": "2024-01-15T00:00:00.000Z",
    "registrationDate": "2024-01-15T00:00:00.000Z",
    "dissolutionDate": null,
    "createdAt": "2024-01-15T10:30:00.000Z",
    "principalOfficeAddress": {
      "line1": "123 Business St",
      "line2": "Suite 100",
      "city": "Próspera",
      "state": null,
      "postalCode": "12345",
      "country": "Honduras"
    },
    "residentPermitNumber": "80000000000012"
  }
}

Error Responses

401 Unauthorized

Invalid or missing API key:

{
  "error": "Invalid API key"
}

404 Not Found

Legal entity not found or you don't have access:

{
  "error": "Legal entity not found"
}

500 Internal Server Error

Server error:

{
  "error": "Internal server error"
}

Access Control

You can only access legal entities for which you are a representative. The API automatically filters results based on your user account and only returns entities where you have representative privileges.