Catalyst Program

Catalyst Program is e-Próspera's referral system. As a Catalyst Program member, you have a unique referral code that can be passed when incorporating entities via the API to attribute them as your referrals.

Referral codes can be owned by:

Natural persons — your personal referral code
Legal entities — a code owned by a company you represent

Incorporating Entities with a Referral Code

When creating a legal entity application, you can optionally pass your referralCode to attribute the new entity as your referral. If omitted, the application proceeds normally without any referral attribution.

bash

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": "New Company",
      "extension": "LLC",
      "principalOffice": {
        "line1": "123 Main Street",
        "city": "Roatan",
        "postalCode": "34101",
        "country": "Honduras"
      },
      "contactEmail": "contact@example.com",
      "registeredAgentProvider": "prospera_employment_solutions",
      "registeredAgentDetails": null
    },
    "referralCode": "MYCODE123"
  }'

See the full POST legal_entity_applications reference for all available fields.

Self-Referral Behavior

By default, using your own referral code on an entity you're creating will silently skip the referral attribution — the application still succeeds, just without being counted as a referral.

If your code has self-referral enabled (configured by an admin), you can use your own code to attribute entities you create via API as referrals. This is useful for companies that incorporate entities on behalf of clients using a single API key.

Checking Your Referrals

Use the referrals endpoint to list natural persons and legal entities referred with your code:

bash

curl -X GET https://portal.eprospera.com/api/v1/referral-codes/MYCODE123/referrals \
  -H "Authorization: Bearer <your-api-key>"

Response

json

{
  "code": "MYCODE123",
  "naturalPersons": [
    {
      "fullName": "John Doe",
      "referredAt": "2024-03-15T14:30:00.000Z"
    }
  ],
  "legalEntities": [
    {
      "name": "Acme Corp LLC",
      "rpn": "80123456789012",
      "referredAt": "2024-04-01T12:00:00.000Z"
    }
  ]
}

See the full GET referral_codes/[code]/referrals reference for details.

Access Control

You can only access referral codes that belong to you:

Codes associated with your natural person account
Codes associated with legal entities where you are a representative

Catalyst Program ​

Incorporating Entities with a Referral Code ​

Self-Referral Behavior ​

Checking Your Referrals ​