> For the complete documentation index, see [llms.txt](https://swappulse.gitbook.io/swappulse-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://swappulse.gitbook.io/swappulse-docs/apis/product-api-reference/catalogue-api.md).

# Catalogue API

Card, set and catalogue search endpoints.

The catalogue endpoints return canonical Pokémon TCG cards and sets. Use canonical IDs whenever possible and pass an explicit language where the operation supports it.

## Get cards

{% openapi src="<https://raw.githubusercontent.com/beitmenotyou1/swappulse2/main/openapi.yaml>" path="/functions/get-cards" method="post" %}
<https://raw.githubusercontent.com/beitmenotyou1/swappulse2/main/openapi.yaml>
{% endopenapi %}

## Get card detail

{% openapi src="<https://raw.githubusercontent.com/beitmenotyou1/swappulse2/main/openapi.yaml>" path="/functions/get-card-detail" method="post" %}
<https://raw.githubusercontent.com/beitmenotyou1/swappulse2/main/openapi.yaml>
{% endopenapi %}

## Get sets

{% openapi src="<https://raw.githubusercontent.com/beitmenotyou1/swappulse2/main/openapi.yaml>" path="/functions/get-sets" method="post" %}
<https://raw.githubusercontent.com/beitmenotyou1/swappulse2/main/openapi.yaml>
{% endopenapi %}

## Search cards

{% openapi src="<https://raw.githubusercontent.com/beitmenotyou1/swappulse2/main/openapi.yaml>" path="/functions/search-cards" method="post" %}
<https://raw.githubusercontent.com/beitmenotyou1/swappulse2/main/openapi.yaml>
{% endopenapi %}

## Guidance

* Use the exact card or set identifier returned by the catalogue.
* Paginate broad lists and keep search terms specific.
* Cache stable catalogue metadata in line with response headers.
* Treat price and market fields as time-sensitive enrichment, not permanent card metadata.