---
title: "Get V3 Upgrade Status"
method: GET
path: "/companies/{company_id}/v3-upgrade"
tags: ["founding"]
---

# Get V3 Upgrade Status

`GET /companies/{company_id}/v3-upgrade`

## Request

- Base URL: `https://api.nanocorp.so` (the document declares no server; this is the origin it was published from)
- URL: `https://api.nanocorp.so/companies/{company_id}/v3-upgrade`
- Auth: HTTP bearer

Sheet + upgrade-page loader: interview state, standing, eligibility.

## Path parameters

- `company_id` string, uuid, required

## Response `200`

Successful Response

- V3UpgradeStatusResponse: Sheet + upgrade-page loader: current-interview fields plus D9 standing.
  - `founding` FoundingResponse
    - `id` string, required
    - `status` string, required
    - `founding_requested_at` string, date-time, nullable
    - `idea` string, required
    - `name` string, nullable, required
    - `handle` string, nullable, required
    - `company_id` string, nullable, required
    - `session_id` string, nullable, required
    - `error` string, nullable, required
    - `interrupt_requested_at` string, date-time, nullable
    - `kind` string
    - `runtime` string
    - `interview_session_id` string, nullable
    - `origin_kind` string
    - `import_repo_full_name` string, nullable
    - `import_branch` string, nullable
    - `import_status` string, nullable
    - `import_error` string, nullable
    - `import_updated_at` string, date-time, nullable
    - `import_retryable` boolean
    - `import_provider` string, nullable
    - `import_source` FoundingImportSource: The project a start imports, provider-neutral, for the source card.
      - `provider` string, required
      - `name` string, required
      - `url` string, nullable
      - `detail` string, nullable
    - `import_phase` string, nullable
    - `import_failure_reason` string, nullable
    - `import_next_action` string, nullable
  - `messages` FoundingMessageResponse[]
    - `seq` integer, required
    - `content` object, required
    - `attachments` object[], nullable
  - `documents` FoundingDocumentResponse[]
    - `id` string, required
    - `target` string, required
    - `version` integer, required
    - `rendered_markdown` string, required
  - `checklist` FoundingChecklistItem[]
    - `step` string, required
    - `status` string, required
  - `segment_running` boolean
  - `tail_needs_repair` boolean
  - `claim_age_seconds` number, nullable
  - `site_domain` string, nullable
  - `first_page_started` boolean
  - `standing` FoundingGatePayload: The standing-to-found card, without the 402 ``error`` envelope. Same fields the FOUND press returns inside ``FoundingGateError``. ``None`` on the upgrade GET means standing is present (the sheet keeps Switch to v3).
    - `kind` string, required
    - `message` string, required
    - `credits` number, required
    - `needed` number, required
    - `has_plan` boolean, required
    - `plan_past_due` boolean
    - `refill_at` string, nullable
    - `auto_topup_enabled` boolean
  - `eligible` boolean

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-02** `c4a504a5119e`: 6 info
  - added the optional property `first_page_started` to the response with the `200` status
  - added the optional property `founding/anyOf[subschema #1: FoundingResponse]/import_failure_reason` to the response with the `200` status
  - added the optional property `founding/anyOf[subschema #1: FoundingResponse]/import_next_action` to the response with the `200` status
  - added the optional property `founding/anyOf[subschema #1: FoundingResponse]/import_phase` to the response with the `200` status
  - …2 more
- **2026-10-01** `92927828a2d0`: 1 info
  - added the optional property `founding/anyOf[subschema #1: FoundingResponse]/founding_requested_at` to the response with the `200` status
- **2026-09-28** `9c76d9123b22`: 9 info
  - added the optional property `founding/anyOf[subschema #1: FoundingResponse]/import_branch` to the response with the `200` status
  - added the optional property `founding/anyOf[subschema #1: FoundingResponse]/import_error` to the response with the `200` status
  - added the optional property `founding/anyOf[subschema #1: FoundingResponse]/import_repo_full_name` to the response with the `200` status
  - added the optional property `founding/anyOf[subschema #1: FoundingResponse]/import_retryable` to the response with the `200` status
  - …5 more
- **2026-09-09** `1229e41b14fd`: 1 info
  - added the optional property `messages/items/attachments` to the response with the `200` status
- …earlier changes not shown

[Operation history](https://skmtc.dev/nanocorp/apis/nanocorp-api/changes/companies/:company_id/v3-upgrade/get.md)

---

[API](https://skmtc.dev/nanocorp/apis/nanocorp-api.md) - [All operations](https://skmtc.dev/nanocorp/apis/nanocorp-api/llms.txt) - [OpenAPI document](https://skmtc.dev/nanocorp/apis/nanocorp-api/revisions/291bb76b720b?raw)