Formations

Submit formation

Create a draft formation and start payment. Returns a Stripe checkout_url unless the account has a saved card, in which case the charge happens inline and charged_inline is true.

post/formations

Request

  • Base URL: https://api.crevio.co/v1
  • URL: https://api.crevio.co/v1/formations
  • Auth: API key in header Authorization

Headers

Idempotency-Keystring

Makes this write safe to retry: a repeat with the same key replays the first response instead of creating a second resource. Scoped to the account, remembered for 24 hours; reusing a key with a different payload is an error.

Request body

entity_type'LLC' required

Today doola only supports LLC

statestring required

Two-letter US state code (e.g. WY)

naics_codestring required

6-digit NAICS code (from GET /v1/formations/naics_codes)

descriptionstring required
phone_numberstring
verification_idstring

KYC verification id from the active KYC provider. Optional — omitted means auto-resolve via the configured provider.

Response

Formation created

idstring required
objectstring required
status'awaiting_payment' | 'pending' | 'submitted' | 'completed' | 'failed' required
entity_type'LLC' required
statestring required
naics_codestring required
industrystring nullable required
descriptionstring required
responsible_partyobject required
mailing_addressobject required
einstring nullable required
formation_filing_datestring nullable required
formation_filing_numberstring nullable required
doola_errorstring nullable required
stripe_checkout_session_idstring nullable required
submitted_atstring nullable required
created_atstring date-time required
updated_atstring date-time required
doola_company_idstring nullable required
verification_idstring nullable required
payment_status'unpaid' | 'paid' | 'refunded' required
checkout_urlstring nullable

Present when hosted checkout is needed

charged_inlineboolean

True when card-on-file charged inline without redirect

Changes

No recorded changes to this operation across all 2 revisions of this API.