GVRN OneShot API

The OneShot catalogue

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.

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

Response

restrictedCountryCodesstring[] required

ISO 3166-1 alpha-3; a founder tax-resident here cannot file

bankingRiskCountryCodesstring[] required

ISO 3166-1 alpha-3; filing is fine, banking takes longer

Example response

{
  "entities": [
    {
      "key": "delaware-c-corp",
      "jurisdiction": "DELAWARE",
      "entityType": "CORPORATION",
      "displayName": "Delaware C-Corp",
      "nameSuffix": ", Inc.",
      "priceUsd": 700,
      "renewalPriceUsd": 500,
      "incorporationTimeLabel": "1–3 days",
      "governingDocumentLabel": "Bylaws & stock issuance",
      "minOfficers": 1,
      "officerTitles": [
        "President",
        "Secretary",
        "Treasurer"
      ],
      "authorizedAmount": 10000000,
      "highlights": [
        "Built for startups that will raise from VCs",
        "Stock options and a clean path to a priced round"
      ]
    }
  ],
  "purposes": [
    {
      "label": "Startup founder",
      "description": "Raising from investors, hiring, issuing equity",
      "recommendedEntityKey": "delaware-c-corp"
    }
  ],
  "requestKinds": [
    {
      "label": "Request a document",
      "description": "A copy of a document GVRN holds for the company, certified or apostilled if a bank needs it.",
      "suggestedFields": [
        "Document",
        "Copy type",
        "Needed by"
      ],
      "examples": [
        "Certificate of incorporation or formation",
        "Certified true copy for a bank account opening"
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.