---
title: "fetch the list of cards"
method: GET
path: "/cards"
tags: ["cards"]
---

# fetch the list of cards

`GET /cards`

Returns a list of all cards, with support for filtering, sorting, and pagination

## Query parameters

- `filters` union
  - object
  - unknown
- `sort:field` union
  - string
  - unknown
- `sort:order` union
  - 'ASC' | 'DESC'
  - 'ASC' | 'DESC'
- `pagination:page` union
  - integer
  - unknown
- `pagination:itemsPerPage` union
  - integer
  - unknown

## Response `200`

Successful request

- CardResume[]
  - `id` string, required — Unique identifier of the card
  - `localId` string, required — Card number within its set
  - `image` union — URL to the card image
    - string
    - unknown
  - `name` string, required — Name of the card (including any suffix)

## Other responses

- `400` — The request was invalid
- `500` — An unexpected error occurred on the server

---

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