---
title: "List incorporations"
method: GET
path: "/public/one-shot/incorporations"
tags: ["GVRN OneShot API"]
---

# List incorporations

`GET /public/one-shot/incorporations`

## Request

- Base URL: `https://docs.gvrn.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.gvrn.ai/public/one-shot/incorporations`
- Auth: API key in header `x-gvrn-public-api-key`

Every incorporation started through this partner's keys, newest first. Filter by `founderEmail` to show one founder their companies, and by `status` to separate drafts from filed ones.

## Query parameters

- `limit` number
- `offset` number
- `orderBy` 'created_at' | 'updated_at' | 'filed_at'
- `direction` 'asc' | 'desc'
- `founderEmail` string
- `status` 'DRAFT' | 'SUBMITTED' | 'CANCELLED'

## Response `200`

- OneShotIncorporationListApiResponseDto
  - `limit` number, required
  - `offset` number, required
  - `total` number, required: Matching the filters, not on this page
  - `result` OneShotIncorporationSummaryApiResponseDto[], required
    - `id` string, required
    - `status` 'DRAFT' | 'SUBMITTED' | 'IN_PROGRESS' | 'REQUIRES_INFO' | 'ACTIVE' | 'CANCELLED', required: SUBMITTED until GVRN starts, then IN_PROGRESS — or REQUIRES_INFO while a request is open against the company. ACTIVE is the company existing on GVRN's records: an EIN for a US entity, a registration offshore.
    - `filingStatus` 'DRAFT' | 'SUBMITTED' | 'CANCELLED', required: The stored lifecycle state behind status
    - `founderEmail` string, required
    - `purpose` 'STARTUP_FOUNDER' | 'INVESTOR' | 'DIGITAL_NOMAD' | 'UNSURE'
    - `kycType` 'GVRN' | 'EXTERNAL', required
    - `jurisdiction` 'SINGAPORE' | 'PANAMA' | 'BVI' | 'DELAWARE' | 'WYOMING' | 'CAYMAN_ISLANDS' | 'COSTA_RICA' | 'DUBAI' | 'SEYCHELLES' | 'SWITZERLAND' | 'OTHERS'
    - `entityType` 'IBC' | 'FOUNDATION' | 'SPC' | 'PTE_LTD' | 'SRL' | 'SA' | 'LIMITED' | 'CORPORATION' | 'LLC'
    - `entityKey` string: The catalogue entry the pair resolves to
    - `preferredCompanyNames` string[], required: In preference order
    - `parentCompanyId` string: Set on a subsidiary; the parent holds every share
    - `company` OneShotCompanySummaryDto
      - `id` string, required
      - `displayName` string, required
      - `legalName` string: Set by GVRN once the registry confirms the name
      - `fullDisplayName` string, required: Display name with the entity suffix
      - `jurisdiction` 'SINGAPORE' | 'PANAMA' | 'BVI' | 'DELAWARE' | 'WYOMING' | 'CAYMAN_ISLANDS' | 'COSTA_RICA' | 'DUBAI' | 'SEYCHELLES' | 'SWITZERLAND' | 'OTHERS'
      - `incorporationStatus` 'INCORPORATED' | 'INCORPORATION_NOT_STARTED' | 'IN_PROGRESS' | 'REGISTERED' | 'LIVE' | 'AMALGAMATED' | 'IN_LIQUIDATION' | 'UNDER_JUDICIAL_MANAGEMENT' | 'REVOKED' | 'STRIKING_OFF' | 'STRUCK_OFF' | 'GAZETTED_TO_BE_STRUCK_OFF' | 'SUSPENDED' | 'CONVERTED' | 'DISSOLVED' | 'CANCELLED' | 'UNKNOWN_EXTERNAL', required
      - `registrationNumber` string: Issued by the registry
      - `taxNumber` string: The EIN for a US entity
      - `incorporatedAt` string: ISO 8601
    - `quotedPriceUsd` number: Catalogue price at filing
    - `filedAt` string: ISO 8601
    - `signedAt` string: ISO 8601
    - `createdAt` string, required: ISO 8601
    - `updatedAt` string, required: ISO 8601

---

[API](https://skmtc.dev/gvrn/apis/gvrn-oneshot-api.md) · [All operations](https://skmtc.dev/gvrn/apis/gvrn-oneshot-api/llms.txt) · [OpenAPI document](https://skmtc.dev/gvrn/apis/gvrn-oneshot-api/revisions/31a2ef047b90?raw)