Skip to main content

Documentation Index

Fetch the complete documentation index at: https://usenaive.ai/docs/llms.txt

Use this file to discover all available pages before exploring further.

This is the first step of company formation. It validates the KYC verification, creates a formation record, and returns a Stripe Checkout URL for the $249 formation fee. After the user pays, call POST /v1/formation/:id/submit to actually submit to Doola.
​
verification_id
string
required
UUID of a completed KYC verification (ready_for_formation: true).
​
entity_type
string
required
Entity type. Currently "LLC".
​
state
string
required
2-letter US state code (e.g. "WY", "DE").
​
naics_code_id
string
required
NAICS code ID from GET /v1/formation/naics-codes.
​
description
string
required
Business description (max 256 characters).
​
name_options
array
required
Company name options. At least 1 required, recommend 3 for availability. Each has name and entity_type_ending.
​
mailing_address
object
Optional. Defaults to the primary member’s address from KYC if not provided. If provided, must include line1, city, state, postal_code, country, phone.
curl -X POST https://api.usenaive.ai/v1/formation \
  -H "Authorization: Bearer nv_sk_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "verification_id": "3dcde53f-abaa-4bb6-a5b5-2d704fad6c19",
    "entity_type": "LLC",
    "state": "WY",
    "naics_code_id": "2o8v0kcaCWyPyi3LJFsCiTCFSyk",
    "description": "AI-powered business automation",
    "name_options": [
      { "name": "Acme Tech", "entity_type_ending": "LLC" },
      { "name": "Acme Solutions", "entity_type_ending": "LLC" }
    ]
  }'

{
  "id": "formation-uuid",
  "status": "awaiting_payment",
  "payment_status": "unpaid",
  "checkout_url": "https://checkout.stripe.com/c/pay/cs_test_xxx",
  "checkout_session_id": "cs_test_xxx",
  "price_usd": "$249",
  "entity_type": "LLC",
  "state": "WY",
  "name_options": [
    { "name": "Acme Tech", "entity_type_ending": "LLC" },
    { "name": "Acme Solutions", "entity_type_ending": "LLC" }
  ],
  "next_step": "Open the checkout_url to complete payment, then call POST /v1/formation/:id/submit to submit to Doola"
}
The user must open the checkout_url and pay the $249 formation fee. Once paid, the Stripe webhook updates the formation’s payment_status to paid. After that, call POST /v1/formation/:id/submit to trigger the Doola submission.