GVRN OneShot API

List incorporations

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.

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

Query parameters

limitnumber
Example:20

Page size. Defaults to 20, capped at 100.

offsetnumber

How many to skip; newest first by default

orderBy'created_at' | 'updated_at' | 'filed_at'
Example:created_at

Order by field: created_at, updated_at, filed_at

direction'asc' | 'desc'
Example:desc
founderEmailstring

Only incorporations started by this founder, matched case-insensitively

status'DRAFT' | 'SUBMITTED' | 'CANCELLED'
Example:SUBMITTED

Response

limitnumber required
offsetnumber required
totalnumber required

Matching the filters, not on this page

Example response

{
  "limit": 20,
  "total": 3,
  "result": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "status": "ACTIVE",
      "filingStatus": "SUBMITTED",
      "founderEmail": "qa+founder@gvrn.ai",
      "purpose": "STARTUP_FOUNDER",
      "kycType": "GVRN",
      "jurisdiction": "DELAWARE",
      "entityType": "CORPORATION",
      "entityKey": "delaware-c-corp",
      "preferredCompanyNames": [
        "Marlow Labs",
        "Marlow Holdings"
      ],
      "parentCompanyId": "123e4567-e89b-12d3-a456-426614174000",
      "company": {
        "id": "123e4567-e89b-12d3-a456-426614174000",
        "displayName": "Marlow Labs",
        "legalName": "Marlow Labs, Inc.",
        "fullDisplayName": "Marlow Labs, Inc.",
        "jurisdiction": "DELAWARE",
        "incorporationStatus": "INCORPORATED",
        "registrationNumber": "7854219",
        "taxNumber": "93-4821570",
        "incorporatedAt": "2026-09-02T09:12:44.000Z"
      },
      "quotedPriceUsd": 500,
      "filedAt": "2026-09-02T09:12:44.000Z",
      "signedAt": "2026-09-02T09:12:44.000Z",
      "createdAt": "2026-09-02T09:12:44.000Z",
      "updatedAt": "2026-09-02T09:12:44.000Z"
    }
  ]
}

Changes

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