POST legal_entity_applications

Create a new legal entity application for incorporation in Próspera.

Endpoint

POST /api/v1/legal_entity_applications

Authentication

Requires a valid API key in the Authorization header:

Authorization: Bearer <your-api-key>

Prerequisites

• You must be an active resident (e-Resident or Resident) to create legal entity applications
• Only LLC entity types are currently supported via the API

Request Body

Field	Type	Required	Description
applicationData	object	Yes	Complete application data
redirectUrl	string	No	URL to redirect to after signature completion

Application Data Object

Field	Type	Required	Description
residencyType	string	Yes	Either "e-Resident" or "Resident"
entityType	string	Yes	Must be "llc"
name	string	Yes	Legal entity name (without extension)
extension	string	Yes	Legal entity extension
principalOffice	object	Yes	Principal office address
contactEmail	string	Yes	Contact email address
registeredAgentProvider	string | null	Optional	Use "prospera_employment_solutions" or null
registeredAgentDetails	object | null	Optional	Custom registered agent details
analytics	object	No	Optional analytics information

Extension Values

Valid values for extension:

• "LLC"
• "L.L.C."
• "Limited Liability Company"
• "S. de R.L."
• "SRL"
• "Limited Company"
• "L.C."
• "LC"
• "Limited Liability Co."
• "Limited Co."
• "Ltd. Co."

Principal Office Address

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

Registered Agent Details (if not using provider)

Field	Type	Required	Description
attn	string	Yes	Attention/contact name
residentPermitNumber	string	Yes	RPN of registered agent
officeAddress	object	Yes	Office address
mailingAddress	object	Yes	Mailing address

Analytics Object (Optional)

Field	Type	Description
industry	string	Industry classification
whatIsYourBusinessIntendingToDo	string	Business intentions
howDidYouHearAboutProspera	string	Referral source
whyChooseProspera	string	Reason for choosing Próspera
website	string	Company website

Example Request

curl -X POST https://portal.eprospera.com/api/v1/legal_entity_applications \
  -H "Authorization: Bearer <your-api-key>" \
  -H "Content-Type: application/json" \
  -d '{
    "applicationData": {
      "residencyType": "e-Resident",
      "entityType": "llc",
      "name": "Example Tech Company",
      "extension": "LLC",
      "principalOffice": {
        "line1": "123 Business St",
        "city": "Próspera",
        "postalCode": "12345",
        "country": "Honduras"
      },
      "contactEmail": "contact@example.com",
      "registeredAgentProvider": "prospera_employment_solutions",
      "registeredAgentDetails": null,
      "analytics": {
        "industry": "Technology",
        "whatIsYourBusinessIntendingToDo": "Software development services"
      }
    },
    "redirectUrl": "https://example.com/success"
  }'

Response

Success Response (200 OK)

Field	Type	Description
data	object	Created application object
nextSteps	object	Next steps information

Application Object

Field	Type	Description
id	string	Application unique identifier
statusId	string	Always "Draft" for new applications
applicationData	object	Complete application data
applicationVersion	string	Application format version
submittedAt	null	Always null for new applications
createdAt	string	Creation timestamp (ISO 8601)
approvedAt	null	Always null for new applications
rejectedAt	null	Always null for new applications
createdViaAPI	boolean	Always true for API-created applications

Next Steps Object

Field	Type	Description
signature	string	URL for signing the Agreement of Coexistence

Example Response

{
  "data": {
    "id": "12345678-abcd-1234-abcd-123456789012",
    "statusId": "Draft",
    "applicationData": { ... },
    "applicationVersion": "1.0.0",
    "submittedAt": null,
    "createdAt": "2024-01-15T10:30:00.000Z",
    "approvedAt": null,
    "rejectedAt": null,
    "createdViaAPI": true
  },
  "nextSteps": {
    "signature": "https://portal.eprospera.com/en/application/api-terms/12345678-abcd-1234-abcd-123456789012?token=..."
  }
}

Error Responses

400 Bad Request

Invalid entity type:

{
  "error": "Only LLCs are supported in the API at this time. Please use the web app to create other entity types."
}

Invalid request body:

{
  "error": "Invalid request body",
  "details": [
    {
      "code": "invalid_type",
      "expected": "string",
      "received": "number",
      "path": ["applicationData", "name"]
    }
  ]
}

Invalid registered agent configuration:

{
  "error": "Either registeredAgentProvider or registeredAgentDetails must be provided, but not both."
}

401 Unauthorized

Invalid or missing API key:

{
  "error": "Invalid API key"
}

403 Forbidden

User not eligible to create applications:

{
  "error": "You must be an active resident to create a legal entity application"
}

500 Internal Server Error

Server error:

{
  "error": "Internal server error"
}

Next Steps

After creating an application, you must:

1. Sign the Articles of Incorporation: Visit the URL provided in nextSteps.signature
2. Complete payment: Use the payment endpoint or apply a coupon
3. Submit the application: The application will be automatically submitted after payment

Important Notes

• Applications created via API start in "Draft" status
• You must complete the signature step before payment can be processed
• Only one representative (yourself) is automatically added to API-created applications
• The redirectUrl parameter allows you to customize where users are redirected after completing the signature process