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

# List formations

`GET /v1/formations`

## Request

- Base URL: `https://api.offshoreproz.com`
- URL: `https://api.offshoreproz.com/v1/formations`
- Auth: HTTP bearer

Lists formations associated with the authenticated API key.

## Query parameters

- `status` 'draft' | 'pending_owner_confirmation' | 'portal_synced' | 'kyc_pending' | 'kyc_review' | 'kyc_approved' | 'kyc_failed' | 'payment_pending' | 'payment_authorized' | 'signature_pending' | 'filing_ready' | 'filing_in_progress' | 'registration_complete' | 'ein_pending' | 'documents_ready' | 'complete' | 'action_required' | 'failed' | 'cancelled'
- `jurisdiction` 'WY' | 'MI' | 'NV' | 'BVI' | 'PA' | 'UAE'
- `limit` integer
- `offset` integer

## Response `200`

Formation list

- object
  - `data` object
    - `formations` object[]
      - `id` string
      - `mode` 'test' | 'live'
      - `status` 'draft' | 'pending_owner_confirmation' | 'portal_synced' | 'kyc_pending' | 'kyc_review' | 'kyc_approved' | 'kyc_failed' | 'payment_pending' | 'payment_authorized' | 'signature_pending' | 'filing_ready' | 'filing_in_progress' | 'registration_complete' | 'ein_pending' | 'documents_ready' | 'complete' | 'action_required' | 'failed' | 'cancelled'
      - `jurisdiction` 'WY' | 'MI' | 'NV' | 'BVI' | 'PA' | 'UAE'
      - `company_name` string
      - `amount_total_usd` integer: Amount in USD cents
      - `created_at` string, date-time
      - `updated_at` string, date-time, nullable
      - `completed_at` string, date-time, nullable
      - `next_actions` object[]
        - `type` string
        - `url` string
    - `total` integer
  - `request_id` string

## Other responses

- `401`: Unauthorized — invalid or missing API key

---

[API](https://skmtc.dev/offshoreproz/apis/offshoreproz-agent-api.md) · [All operations](https://skmtc.dev/offshoreproz/apis/offshoreproz-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/offshoreproz/apis/offshoreproz-agent-api/revisions/13026c827538?raw)