---
title: "List formations"
method: GET
path: "/formations"
tags: ["Formations"]
---

# List formations

`GET /formations`

## Request

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

Returns all business formations for the account, newest first.

## Query parameters

- `starting_after` string
- `limit` integer

## Response `200`

List of formations

- ListResponseFormation
  - `object` 'list', required
  - `data` Formation[], required
    - `id` string, required
    - `object` string, required
    - `status` 'awaiting_payment' | 'pending' | 'submitted' | 'completed' | 'failed', required
    - `entity_type` 'LLC', required
    - `state` string, required
    - `naics_code` string, required
    - `industry` string, nullable, required
    - `description` string, required
    - `name_options` unknown[], required
      - unknown
    - `members` unknown[], required
      - unknown
    - `responsible_party` object, required
    - `mailing_address` object, required
    - `ein` string, nullable, required
    - `formation_filing_date` string, nullable, required
    - `formation_filing_number` string, nullable, required
    - `services` unknown[], required
      - unknown
    - `signature_requirements` unknown[], required
      - unknown
    - `admin_notes` unknown[], required
      - unknown
    - `doola_error` string, nullable, required
    - `stripe_checkout_session_id` string, nullable, required
    - `submitted_at` string, nullable, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `required_actions` unknown[], required
      - unknown
    - `doola_company_id` string, nullable, required
    - `verification_id` string, nullable, required
    - `payment_status` 'unpaid' | 'paid' | 'refunded', required
    - `documents` FormationDocument[], required
      - `id` string, required
      - `object` string, required
      - `document_type` string, required
      - `name` string, required
      - `content_type` string, nullable, required
      - `doola_created_at` string, nullable, required
      - `doola_last_modified_at` string, nullable, required
      - `doola_company_id` string, required
      - `download_url` string, nullable, required
  - `has_more` boolean, required
  - `url` string, required

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `403`: Forbidden
- `429`: Rate limit exceeded — 600 requests per minute per credential. Retry after the number of seconds in `Retry-After`.
- `500`: Internal server error

---

[API](https://skmtc.dev/crevio/apis/crevio-api-v1.md) · [All operations](https://skmtc.dev/crevio/apis/crevio-api-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/crevio/apis/crevio-api-v1/revisions/2219f18ad651?raw)