---
title: "Get cards by HP value"
method: GET
path: "/hp/{hp}"
tags: ["filters"]
---

# Get cards by HP value

`GET /hp/{hp}`

Returns cards with the specified HP value, with support for filtering, sorting, and pagination

## Path parameters

- `hp` 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

---

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