---
title: "Get Preview Pages"
method: GET
path: "/companies/{company_id}/preview-pages"
tags: ["vercel"]
---

# Get Preview Pages

`GET /companies/{company_id}/preview-pages`

## 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}/preview-pages`
- Auth: HTTP bearer

Pages discovered on the company's live site, for the workspace preview picker.

Takes a company id only: the fetch destination is always the company's
platform origin, never a client-supplied URL.

## Path parameters

- `company_id` string, uuid, required

## Response `200`

Successful Response

- PreviewPagesResponse: Pages discovered on a company's live site (specs/2026-10-19_SPEC_COMPANY_WORKSPACE_NAVIGATION.md §8.2). ``ready`` = a valid sitemap was read within the scan limits, ``partial`` = root/link fallback or a truncated scan, ``unavailable`` = no usable page data (also an unprovisioned site, with no pages).
  - `status` 'ready' | 'partial' | 'unavailable', required
  - `pages` PreviewPage[]
    - `path` string, required
    - `source` 'root' | 'sitemap' | 'link', required
  - `truncated` boolean

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-20** `85afb5563d7a`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/nanocorp/apis/nanocorp-api/changes/companies/:company_id/preview-pages/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)