---
title: "Lists information on cards"
method: POST
path: "/cards/list"
tags: ["cards"]
---

# Lists information on cards

`POST /cards/list`

Simple listing of cards.  No filters can be applied.

## Request body

- object
  - `uid` string — optional authorized UID of the session. By providing this, the card list will include user-specific cards.
  - `category_id` integer — optional category id filter

## Response `200`

successful operation

- Card[]
  - `id` integer
  - `name` string
  - `cover` string — cover image of card
  - `cover_width` string — the width in px of the cover image
  - `cover_height` string — the height in px of the cover image
  - `price` number — the base price of a card (in USD)
  - `category_id` integer — the associated category id
  - `available_free` integer — 1 for cards that are available free

## Other responses

- `400` — Invalid status value

---

[API](https://skmtc.dev/swaggerhub/apis/handwrytten-api.md) · [All operations](https://skmtc.dev/swaggerhub/apis/handwrytten-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/swaggerhub/handwrytten-api/revisions/45e7c951cdd6/schema)