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

# Get formation status

`GET /v1/formations/{id}`

## Request

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

Returns current status, next required actions, and provider details.

## Path parameters

- `id` string, required

## Response `200`

Formation detail

- object
  - `data` 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
  - `request_id` string

## Other responses

- `401`: Unauthorized — invalid or missing API key
- `404`: Not found

---

[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)