---
title: "List snippets"
method: GET
path: "/v4/snippets"
tags: ["Snippets"]
---

# List snippets

`GET /v4/snippets`

Returns every snippet on the account. Each snippet's `key` is the identifier used in Liquid — `{{ snippet.key }}` — when creating a broadcast or sequence email. See [Create a snippet](/api-reference/snippets/create-a-snippet) for how snippets work end-to-end.

**Tip:** the heavier `content` and `document` fields are omitted by default to keep responses fast. Pass `include_content=true` when you need the body — for example, to render a preview or audit Liquid usage.

Filter the result with `snippet_type` (`inline` or `block`) and `archived` (defaults to `false`, set `true` to list only archived snippets).

## Query parameters

- `after` unknown
- `archived` unknown
- `before` unknown
- `include_content` boolean
- `include_total_count` boolean
- `per_page` unknown
- `snippet_type` unknown

## Response `200`

Returns a paginated list of all snippets for your account

- object
  - `snippets` object[], required
    - `id` integer, required
    - `name` string, required
    - `snippet_type` string, required
    - `archived` boolean, required
    - `key` string, required
    - `created_at` string, required
    - `updated_at` string, required
    - `content` string, required
    - `document` object, required
      - `id` integer, required
      - `value` unknown, required
      - `value_html` string, required
      - `value_plain` unknown, required
      - `version` integer, required
  - `pagination` object, required
    - `has_previous_page` boolean, required
    - `has_next_page` boolean, required
    - `start_cursor` string, required
    - `end_cursor` string, required
    - `per_page` integer, required

## Other responses

- `401` — Returns a 401 if the token and/or account cannot be authenticated

---

[API](https://skmtc.net/kit/apis/kit-api.md) · [All operations](https://skmtc.net/kit/apis/kit-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/kit/kit-api/revisions/0df0c90d12da/schema)
