e-Próspera
Use cases

Incorporate LLCs as a formation platform

Create Próspera LLC applications, take payment, poll to approval, and deliver the entity documents — end to end over the API.

View as Markdown

You run an incorporation service, a startup-in-a-box product, or a law-firm workflow tool, and you want to form Próspera LLCs for your customers programmatically.

Credential: a standard API key (sk-) for the hosted-checkout flow, or an Agent Key (ak-) with write scopes for the fully automated voucher flow. The application is always created on behalf of an active Resident or e-Resident.

The flow

  1. Create the applicationPOST legal_entity_applications with the entity name, extension, principal office, and registeredAgentProvider. The response includes nextSteps (signature, payment).
  2. Take payment — either:
    • Hosted checkout session (sk- only): redirect your customer to the returned URL; supports card and Bitcoin/Lightning providers.
    • Voucher: fully server-side when a voucher covers the invoice — this is the only payment path available to Agent Keys.
  3. Poll to approvalGET legal_entity_applications/{id} every 5–30 seconds during an active session, backing off after. Terminal states are Approved and Rejected.
  4. Deliver the entity — on approval the application exposes legalEntityId; fetch the entity and its documents (certificate of incorporation and filings) for your customer.

The complete request payloads, signature (AOC) handling, and a copy-paste CLI version live in the Incorporating an entity tutorial and Agent recipes (Recipes 2 & 3).

# Fully automated CLI variant (Agent Key + voucher)
eprospera --json --yes application create --file application.json
eprospera --json --yes application pay <APP_ID> --voucher "<CODE>"
eprospera --json application get <APP_ID>   # poll until Approved

Signature step

The Agreement of Coexistence must be signed by the entity owner. With an Agent Key whose Manifestation of Will pre-accepted the AOC, incorporation is zero-browser; otherwise the create response includes nextSteps.signature and the owner completes it in the portal.

Track your referrals

If you're a Catalyst Program member, pass your referralCode in the create-application body to attribute each incorporation, then list what you've referred with GET referral_codes/{code}/referrals (sk- only). The endpoint reports attribution only — invoice and discount state are not exposed.

What this API does not do

  • No public webhooks — poll application status.
  • Hosted checkout is not available to Agent Keys (voucher or portal payment only).
  • Application lists via Agent Keys only include API-created records.

Next steps

On this page