---
title: "Get formation"
method: GET
path: "/formations/{id}"
tags: ["Formations"]
---

# Get formation

`GET /formations/{id}`

## Request

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

Returns the current state of a formation, including status, documents, and the most recent doola error if any.

## Path parameters

- `id` string, required

## Response `200`

Formation

- Formation
  - `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

## Other responses

- `400`: Bad request
- `401`: Authentication required
- `403`: Forbidden
- `404`: Resource not found
- `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)