---
title: "List available motives"
method: GET
path: "/motives"
tags: ["Motives"]
---

# List available motives

`GET /motives`

## Request

- Base URL: `https://api.echtpost.de/v2`
- URL: `https://api.echtpost.de/v2/motives`
- Auth: one of:
  - OAuth 2 (authorization code, authorization URL `https://my.echtpost.de/oauth/authorize`, token URL `https://my.echtpost.de/oauth/token`, scopes: `mcp`)
  - API key in header `X-Api-Key`
  - HTTP bearer

## Query parameters

- `page` integer
- `per_page` integer
- `search` string
- `temporary` 'true' | 'false'
- `sort` 'name' | 'created_at'
- `direction` 'asc' | 'desc'

## Response `200`

OK

- Motive[]
  - `id` integer
  - `name` string
  - `desc` string, nullable
  - `orientation` 'vertical' | 'landscape'
  - `highlight` boolean
  - `content_available` boolean
  - `content_ps_available` boolean
  - `vertical_text_available` boolean
  - `qr_code_available` boolean
  - `has_back_side` boolean: Whether this motive has a custom back-side image attached.
  - `url` string, nullable: Link to the motive page on echtpost.de
  - `preview_image_url` string, uri, nullable: URL to a preview image of the motive front (~300-420px). For your own motives this is a signed asset URL that stays valid until the assets are purged (see assets_purged_at), and anyone holding the link can open the image.
  - `back_side_image_url` string, uri, nullable: URL to a preview image of the custom back side (~300-420px), or null when the motive has no custom back side. Signed asset URL with the same lifetime as preview_image_url.
  - `tags` string[]
  - `temporary` boolean
  - `assets_expires_at` string, date, nullable: Earliest date on which temporary motive assets may be purged. Null for permanent motives or already-purged assets without a pending expiry.
  - `assets_purged_at` string, date-time, nullable
  - `created_at` string, date-time
  - `updated_at` string, date-time

## Other responses

- `401`: Authentication required
- `422`: Unprocessable Entity

---

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