---
title: "List document templates"
method: GET
path: "/documents"
---

# List document templates

`GET /documents`

## Request

- Base URL: `https://rendry.io/api/v1`
- URL: `https://rendry.io/api/v1/documents`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer
  - HTTP bearer

Light rows (DocumentOverview): name, page COUNT and a sketch of the first page. The pages themselves come from GET /documents/{id}.

## Headers

- `X-Rendry-Account` string

## Response `200`

OK

- DocumentOverview[]
  - `id` string, required
  - `name` string, required
  - `pages` integer, required: Number of pages
  - `created_at` string
  - `updated_at` string
  - `format` string: Output format of the first page's canvas, when it names one
  - `canvas` object
    - `width` integer
    - `height` integer
    - `output_format` string: Set when the first page is a document canvas
  - `sketch` object[]: Top-level layer boxes (t = layer type) for a thumbnail sketch before a preview exists
    - `t` string
    - `x` number
    - `y` number
    - `w` number
    - `h` number
  - `composition` object: Top-level layer count per type, e.g. {"text": 2, "image": 1}; group children are not counted

## Other responses

- `401`: Missing/invalid API key

---

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