# Catalyst Program (/catalyst-program)

e-Próspera's referral system: attribute residency and entity signups to your referral code and track referrals via the API.



The Catalyst Program is e-Próspera's referral system. As a member, your referral code supports:

* **Attribution** for referred natural persons and legal entities
* **20% discount** on the first eligible paid natural-person residency application (applied automatically at checkout)

Referral codes can be owned by natural persons or legal entities.

## Residency discount [#residency-discount]

When a user attributed to your code reaches the payment step for an eligible residency application, the discount is applied automatically — no voucher needed.

* Applies to the first paid natural-person residency application only
* Does not apply to free residency options, renewals, entity applications, or other services
* Does not stack with other invoice discounts

## Attributing entity incorporations [#attributing-entity-incorporations]

Pass your `referralCode` when creating a legal-entity application to attribute it as a referral. If omitted, the application proceeds without 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/post-legal-entity-applications) reference for all available fields.

## Self-referral [#self-referral]

By default, using your own referral code silently skips attribution — the application succeeds, but isn't counted as a referral. If your code has **self-referral enabled** (configured by an admin), attribution is recorded. This is useful for companies that incorporate entities on behalf of clients using a single API key.

## Checking referrals [#checking-referrals]

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>"
```

```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/get-referral-codes-code-referrals) reference. This endpoint reports attribution only — it does not expose invoice or discount state.

## Access control [#access-control]

You can only query referral codes that belong to you (your personal code, or codes owned by entities you represent).