GET legal_entity_applications

List legal-entity applications created by the authenticated API-key owner.

Endpoint

GET /api/v1/legal_entity_applications

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>

Example Request

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

Response

Success Response (200 OK)

Field	Type	Description
data	array	Legal-entity applications created by this user.

Application Object

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 once the application is approved.

Example Response

{
  "data": [
    {
      "id": "12345678-abcd-1234-abcd-123456789012",
      "statusId": "Pending Review",
      "applicationData": {
        "createdViaAPI": true,
        "residencyType": "e_resident_entity_zf7j7u",
        "entityDetails": {
          "name": "Example LLC",
          "extension": "LLC"
        }
      },
      "applicationVersion": "1.0.0",
      "submittedAt": "2024-01-15T10:30:00.000Z",
      "createdAt": "2024-01-15T09:15:00.000Z",
      "approvedAt": null,
      "rejectedAt": null,
      "legalEntityId": null
    }
  ]
}

Status Values

• Draft: waiting on payment and/or signature
• Pending Review: submitted and awaiting review
• Approved: approved and converted into a legal entity
• Rejected: rejected by the review team

Pagination

This endpoint is not currently paginated. The full result set is returned in a single response under data. Treat this as the current contract; in the future a pagination envelope (page/pageSize/totalCount/pageCount, matching /api/v1/nomadlayer/applications) may be added — design clients so an additional top-level pagination field would not break them. See Conventions → Pagination.

Notes

• The returned applicationData is the stored internal application format, not the same schema you send to POST /api/v1/legal_entity_applications.
• Use legalEntityId after approval to fetch the final entity via GET /api/v1/legal_entities/{id}.

Error Responses

401 Unauthorized

{
  "error": "Missing API key"
}

or:

{
  "error": "Invalid API key"
}

500 Internal Server Error

{
  "error": "Internal server error"
}

Access Control

This endpoint only returns applications created by your user account. You cannot access applications created by other users.

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