---
title: "List the pages that use a shared section"
method: GET
path: "/api/v1/sites/{slug}/shared-sections/{name}/pages"
tags: ["Content"]
---

# List the pages that use a shared section

`GET /api/v1/sites/{slug}/shared-sections/{name}/pages`

## Request

- Base URL: `https://api.dotsy.ai`
- URL: `https://api.dotsy.ai/api/v1/sites/{slug}/shared-sections/{name}/pages`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer

The section's row, then its pages: how each one gets it (page, layout or another section) and whether it hides it.

## Path parameters

- `slug` string, required
- `name` string, required

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

One page of pages.

- SharedSectionPages
  - `section` SharedSectionRow, required
    - `name` string, required
    - `key` string, required
    - `showsOn` 'every_page' | 'pages', required: `every_page` when a layout places it.
    - `layouts` string[], required: Layouts that place it.
    - `pageCount` integer, required: Pages that show it (pages that hide it are not counted).
    - `hiddenCount` integer, required
    - `exists` boolean, required: False when pages reference a section file that is missing.
    - `hasChanges` boolean, required: The section file has a staged change.
    - `updatedAt` integer, nullable, required: Last write, Unix ms. Null when the store can't tell without extra reads.
  - `pages` object[], required
    - `path` string, required
    - `contentKey` string, nullable, required
    - `title` string, nullable, required
    - `via` 'page' | 'layout' | 'section', required: `page`: the page places it (detach works). `layout`: its layout does (hide works). `section`: another section does.
    - `hidden` boolean, required
  - `nextCursor` string, nullable, required
  - `indexing` object, required
    - `pending` integer, required: Pages whose structure is not indexed yet.
    - `running` boolean, required
  - `partial` boolean, required

## Other responses

- `400`: A query value or `cursor` is not valid.
- `401`: Missing or invalid credentials.
- `404`: No such site, or no such section (`section_not_found`).

---

[API](https://skmtc.dev/dotsy/apis/dotsy-api.md) · [All operations](https://skmtc.dev/dotsy/apis/dotsy-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dotsy/apis/dotsy-api/revisions/4272ed3b85d7?raw)