Skip to main content
POST
/
formations
Typescript (SDK)
import { Crevio } from "@crevio/sdk";

const crevio = new Crevio({
  apiKey: process.env["CREVIO_API_KEY"] ?? "",
});

async function run() {
  const result = await crevio.formations.submit({
      "entityType": "LLC",
      "state": "WY",
      "naicsCode": "812990",
      "description": "Software consultancy",
      "nameOptions": [
          {
              "name": "Acme Inc",
              "entityTypeEnding": "LLC"
          }
      ],
      "members": [
          {
              "legalFirstName": "Jane",
              "legalLastName": "Doe",
              "contactFullName": "Jane Doe",
              "isNaturalPerson": true,
              "ownershipPercent": 100,
              "address": {
                  "line1": "1 Main St",
                  "city": "Cheyenne",
                  "state": "WY",
                  "postalCode": "82001",
                  "country": "USA",
                  "phone": "+15551234567"
              }
          }
      ],
      "responsibleParty": {
          "legalFirstName": "Jane",
          "legalLastName": "Doe",
          "address": {
              "line1": "1 Main St",
              "city": "Cheyenne",
              "state": "WY",
              "postalCode": "82001",
              "country": "USA"
          }
      },
      "mailingAddress": {
          "line1": "1 Main St",
          "city": "Cheyenne",
          "state": "WY",
          "postalCode": "82001",
          "country": "USA"
      }
  });

  console.log(result);
}

run();
{
  "id": "<string>",
  "object": "<string>",
  "state": {},
  "naics_code": {},
  "description": {},
  "name_options": "<array>",
  "members": "<array>",
  "responsible_party": {},
  "mailing_address": {},
  "ein": "<string>",
  "formation_filing_date": "<string>",
  "admin_notes": "<array>",
  "doola_error": "<string>",
  "stripe_checkout_session_id": "<string>",
  "submitted_at": "<string>",
  "created_at": {},
  "updated_at": {},
  "doola_company_id": "<string>",
  "verification_id": "<string>",
  "documents": [
    {
      "id": "<string>",
      "object": "<string>",
      "name": {},
      "content_type": {},
      "doola_created_at": "<string>",
      "doola_last_modified_at": "<string>",
      "doola_company_id": "<string>",
      "download_url": "<string>"
    }
  ],
  "checkout_url": "<string>",
  "charged_inline": true
}

Documentation Index

Fetch the complete documentation index at: https://docs.crevio.co/llms.txt

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

Authorizations

​
Authorization
string
header
required

API key in the format: Bearer {api_token}

Body

application/json
​
entity_type
enum<string>
required

Today doola only supports LLC

Available options:
LLC
​
state
string
required

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

​
naics_code
string
required

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

​
description
string
required
Maximum string length: 250
​
name_options
object[]
required
Required array length: 1 - 3 elements
​
members
object[]
required

LLC members. Ownership percentages must sum to exactly 100.

Minimum array length: 1
​
responsible_party
object
required
​
mailing_address
object
required
​
phone_number
string
​
verification_id
string

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

Response

Formation created

​
id
string
required
​
object
string
required
​
status
enum<string>
required
Available options:
awaiting_payment,
pending,
submitted,
completed,
failed
​
entity_type
enum<string>
required
Available options:
LLC
​
state
object
required
​
naics_code
object
required
​
description
object
required
​
name_options
array
required
​
members
array
required
​
responsible_party
object
required
​
mailing_address
object
required
​
ein
string | null
required
​
formation_filing_date
string | null
required
​
admin_notes
array
required
​
doola_error
string | null
required
​
stripe_checkout_session_id
string | null
required
​
submitted_at
string | null
required
​
created_at
object
required
​
updated_at
object
required
​
doola_company_id
string | null
required
​
verification_id
string | null
required
​
payment_status
enum<string>
required
Available options:
unpaid,
paid,
refunded
​
documents
object[]
required
​
checkout_url
string | null

Present when hosted checkout is needed

​
charged_inline
boolean

True when card-on-file charged inline without redirect