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

# The OneShot catalogue

`GET /public/one-shot/catalogue`

## 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/catalogue`
- Auth: API key in header `x-gvrn-public-api-key`

Everything an incorporation flow renders before a founder types anything: the entities on offer with
their first-year and renewal prices, timing, governing documents and filing rules; the purposes a
founder can pick and which entity each one recommends; and the country codes that block or
complicate filing.

Prices are GVRN's current ones and can change, so read them when you render a card rather than
storing them. An entity GVRN has no price for is left out, along with any purpose recommending it.

Pass an entity's `jurisdiction` and `entityType` back on the incorporation; its `key` is how the
recommendation and the incorporation's `entityKey` refer to it.

`requestKinds` is the menu of what a founder can ask GVRN for once the company is filed; each
entry's `suggestedFields` say what that kind's form should collect.

## Response `200`

- OneShotCatalogueApiResponseDto
  - `entities` OneShotEntityCatalogueItemDto[], required
    - `key` string, required: Stable handle the recommendation and entityKey point at
    - `jurisdiction` 'SINGAPORE' | 'PANAMA' | 'BVI' | 'DELAWARE' | 'WYOMING' | 'CAYMAN_ISLANDS' | 'COSTA_RICA' | 'DUBAI' | 'SEYCHELLES' | 'SWITZERLAND' | 'OTHERS', required
    - `entityType` 'IBC' | 'FOUNDATION' | 'SPC' | 'PTE_LTD' | 'SRL' | 'SA' | 'LIMITED' | 'CORPORATION' | 'LLC', required
    - `displayName` string, required
    - `nameSuffix` string, required: Appended to the chosen name
    - `priceUsd` number, required: The first year, all in: what GVRN quotes the founder, and what filing records
    - `renewalPriceUsd` number, required: Each year after the first
    - `incorporationTimeLabel` string, required
    - `governingDocumentLabel` string, required: What the founder signs after filing
    - `minOfficers` number, required: Directors required before filing
    - `officerTitles` string[]
    - `authorizedAmount` number, required: Shares or units the ownership percentages are converted against
    - `ownershipUnit` 'SHARES' | 'UNITS', required
    - `privacy` 'STANDARD' | 'MODERATE' | 'HIGH', required
    - `banking` 'EXCELLENT' | 'GOOD' | 'MODERATE' | 'HARDER', required
    - `usTax` boolean, required: Whether the company files US federal tax returns
    - `tier` 'US' | 'US_PRIVATE' | 'OFFSHORE', required
    - `highlights` string[], required: Selling points, written to be rendered on a partner's own entity card
  - `purposes` OneShotPurposeCatalogueItemDto[], required
    - `purpose` 'STARTUP_FOUNDER' | 'INVESTOR' | 'DIGITAL_NOMAD' | 'UNSURE', required
    - `label` string, required
    - `description` string, required
    - `recommendedEntityKey` string, required
  - `restrictedCountryCodes` string[], required: ISO 3166-1 alpha-3; a founder tax-resident here cannot file
  - `bankingRiskCountryCodes` string[], required: ISO 3166-1 alpha-3; filing is fine, banking takes longer
  - `requestKinds` OneShotRequestCatalogueItemDto[], required: What a founder can ask GVRN for once the company is filed
    - `kind` 'DOCUMENT' | 'COMPANY_DETAILS' | 'MEMBER_CHANGE' | 'SHARE_CAPITAL' | 'GOVERNANCE' | 'COMPLIANCE_FILING' | 'TAX' | 'ENTITY_CHANGE' | 'OTHER', required
    - `label` string, required
    - `description` string, required
    - `suggestedFields` string[], required: Labels this kind's form should collect into `payload`. Advisory, never validated.
    - `examples` string[], required: Concrete asks this kind covers, ready to offer as suggestions

---

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