GET legal_entity_applications/[id]

Fetch a single legal-entity application created by the authenticated API-key owner.

Endpoint

GET /api/v1/legal_entity_applications/{id}

Authentication

This endpoint accepts:

• a standard API key (sk-)
• an Agent Key (ak-) with the agent:entity.application.read scope

Send the key in the Authorization header:

Authorization: Bearer <your-api-key-or-agent-key>

Path Parameters

Parameter	Type	Required	Description
id	string	Yes	Legal-entity application ID.

Example Request

curl -X GET https://portal.eprospera.com/api/v1/legal_entity_applications/12345678-abcd-1234-abcd-123456789012 \
  -H "Authorization: Bearer <your-api-key-or-agent-key>"

Response

Success Response (200 OK)

Field	Type	Description
data	object	The application record.

data

Field	Type	Description
id	string	Application ID.
statusId	string	Draft, Pending Review, Approved, or Rejected.
applicationData	object	Normalized internal application data.
applicationVersion	string	Application format version.
submittedAt	string | null	ISO 8601 timestamp.
createdAt	string	ISO 8601 timestamp.
approvedAt	string | null	ISO 8601 timestamp.
rejectedAt	string | null	ISO 8601 timestamp.
legalEntityId	string | null	Created legal-entity ID after approval.

Example Response

{
  "data": {
    "id": "12345678-abcd-1234-abcd-123456789012",
    "statusId": "Approved",
    "applicationData": {
      "createdViaAPI": true,
      "residencyType": "e_resident_entity_zf7j7u",
      "entityDetails": {
        "name": "Example Tech Company",
        "extension": "LLC",
        "residentEmail": "contact@example.com",
        "representatives": [
          {
            "residentPermitNumber": "80000000000012"
          }
        ]
      }
    },
    "applicationVersion": "1.0.0",
    "submittedAt": "2024-01-15T10:30:00.000Z",
    "createdAt": "2024-01-15T09:15:00.000Z",
    "approvedAt": "2024-01-16T14:20:00.000Z",
    "rejectedAt": null,
    "legalEntityId": "123e4567-e89b-12d3-a456-426614174000"
  }
}

Notes

• The response payload reflects the stored internal application shape, not the public create schema.
• Use legalEntityId after approval with GET /api/v1/legal_entities/{id}.

Error Responses

401 Unauthorized

{
  "error": "Missing API key"
}

or:

{
  "error": "Invalid API key"
}

404 Not Found

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

500 Internal Server Error

{
  "error": "Internal server error"
}

Access Control

You can only access applications that you created. The API automatically filters results based on your user account.

When you authenticate with an Agent Key, access is further restricted to API-created applications (createdViaAPI: true).