---
title: "List pages"
method: GET
path: "/api/v1/pages"
tags: ["content"]
---

# List pages

`GET /api/v1/pages`

## Request

- Base URL: `https://justautomate.ai`
- URL: `https://justautomate.ai/api/v1/pages`
- Auth: one of:
  - none
  - OAuth 2 (authorization code, authorization URL `https://justautomate.ai/oauth/authorize/`, token URL `https://justautomate.ai/oauth/token/`, scopes: `mcp:read`)

Public pages, optionally filtered by kind and language, with cursor pagination.

## Query parameters

- `type` 'home' | 'section' | 'offer' | 'guide' | 'blog' | 'about' | 'contact' | 'city' | 'legal' | 'other'
- `lang` 'pl' | 'en' | 'de'
- `limit` integer
- `cursor` string

## Response `200`

One page of results.

- PageList
  - `data` PageSummary[], required
    - `title` string, required
    - `url` string, uri, required: Canonical URL of the page.
    - `markdownUrl` string, uri, required: The same page as Markdown.
    - `description` string: Meta description. City pages have none.
    - `type` 'home' | 'section' | 'offer' | 'guide' | 'blog' | 'about' | 'contact' | 'city' | 'legal' | 'other', required
    - `lang` 'pl' | 'en' | 'de', required
  - `total` integer, required: Number of pages matching the filters.
  - `limit` integer, required
  - `next_cursor` string, nullable, required: Pass as cursor to get the next page; null on the last page.

## Other responses

- `400`: A parameter or the request body is invalid (code invalid-parameter or invalid-body).
- `401`: The bearer token is invalid or expired (code invalid-token). Call without a token or get a new one.
- `429`: Rate limit exceeded (code rate-limited). Wait Retry-After seconds.
- `500`: Unexpected error (code internal-error). Retry later.
- `503`: Site data is temporarily unavailable (code unavailable). Wait Retry-After seconds.

---

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