---
title: "Get cards by retreat cost"
method: GET
path: "/retreats/{retreat}"
tags: ["filters"]
---

# Get cards by retreat cost

`GET /retreats/{retreat}`

## Request

- Base URL: `https://api.tcgdex.net/v2/en`
- URL: `https://api.tcgdex.net/v2/en/retreats/{retreat}`
- Auth: none declared
- TypeScript: <https://skmtc.dev/tcgdex/apis/tcgdex-api/docs/retreats/:retreat/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns cards with the specified retreat cost, with support for filtering, sorting, and pagination

## Path parameters

- `retreat` string, required

## 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

- StringEndpoint: Represents a collection of cards matching a specific string value (for endpoints like types, rarities, etc.)
  - `name` string, required: The string value this endpoint represents
  - `cards` CardResume[], required: Cards matching the specific string value
    - `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
- `404`: The specified resource was not found
- `500`: An unexpected error occurred on the server

## Changes

- **2026-07-13** `cc386057cff5`: 8 info
  - added the new optional `query` request parameter `filters`
  - added the new optional `query` request parameter `pagination:itemsPerPage`
  - added the new optional `query` request parameter `pagination:page`
  - added the new optional `query` request parameter `sort:field`
  - …4 more

[Operation history](https://skmtc.dev/tcgdex/apis/tcgdex-api/changes/retreats/:retreat/get.md)

---

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