# Grand Archive TCG Cards API

> Grand Archive trading card game cards: search by name, class, element and type, with every edition

- Vendor: `grandarchivetcgcardsapi` · version 1.0 · category Gaming · tags grand archive api, tcg cards api, trading card game api, card database api, gatcg api, card search api
- Datasource: custom HTTP routes
- Marketplace page: https://apiclay.com/api/grandarchivetcgcardsapi
- This document: https://apiclay.com/docs/grandarchivetcgcardsapi.md
- OpenAPI 3.1: https://apiclay.com/api/grandarchivetcgcardsapi/openapi.json
- MCP: connect https://api.apiclay.com/v1/mcp (see https://apiclay.com/llms.txt), then `apiclay_describe_api` with vendor `grandarchivetcgcardsapi`
- Updated: 2026-11-18

## About

## Grand Archive TCG Cards API

The official Grand Archive TCG card index (index.gatcg.com): search cards by name, class, element, type and rarity, read one card with its cost, stats, effect text, legality and every printed edition (set, collector number, rarity, illustrator, image), draw random cards, and list every filter value the index accepts.

Data comes from **grandarchive.com** (https://www.grandarchive.com). Every route calls the source's own public API and returns it unchanged.

Typical flow: `/options` for filter values, `/search?name=lorraine`, then `/card?slug=lorraine-blademaster`.

### Routes

#### GET `/search` - Search cards
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| name | query | string | no | Card name or part of it. |
| class | query | string | no | e.g. `WARRIOR`, `CLERIC`, `MAGE`. |
| element | query | string | no | e.g. `FIRE`, `WATER`, `WIND`, `NORM`. |
| type | query | string | no | e.g. `CHAMPION`, `ALLY`, `ACTION`. |
| rarity | query | number | no | Rarity number from `/options`. |
| page | query | number | no | Page, from 1. |
| page_size | query | number | no | Cards per page. |

Returns: `data[]` of cards (`name`, `slug`, `uuid`, `classes`, `element`, `types`, `subtypes`, `cost`, `level`, `power`, `life`, `durability`, `effect`, `legality`, `editions[]`), `page`, `total_pages`, `has_more`.

#### GET `/card` - Card
| Param | In | Type | Required | Description |
|---|---|---|---|---|
| slug | path | string | yes | Card `slug`, e.g. `lorraine-blademaster`. |

Returns: one card with all fields and `editions[]` (`set`, `collector_number`, `rarity`, `illustrator`, `image`, `flavor`).

#### GET `/random` - Random cards
No parameters.

Returns: array of random cards with the same fields.

#### GET `/options` - Filter options
No parameters.

Returns: the accepted values for `class`, `element`, `type`, `subtype`, `rarity`, `set`, `gameFormat`, `language` and more, each with `text` and `value`.

### Caveats

- Card text and art are Weebs of the Shore's; check their fan content policy before republishing images.
- Upstream responses can change over time. Verify fields before relying on them.
- Not affiliated with or endorsed by grandarchive.com.

## Pricing

- Pay as you go: 0.0012 credits/request
- Trial: 1 free requests per buyer
- Billing order: trial requests -> subscribed plan requests -> pay as you go. 1 credit's USD value is shown on the marketplace page.

## HTTP routes

Only the public, buyer-facing parts of each route are listed; vendor-side credentials stay on the gateway.

### GET /search — Search cards
- Gateway: `GET https://api.apiclay.com/v1/api/grandarchivetcgcardsapi/search`
- Public query params: `name` (string), `class` (string), `element` (string), `type` (string), `rarity` (number), `page` (number), `page_size` (number)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /card — Card
- Gateway: `GET https://api.apiclay.com/v1/api/grandarchivetcgcardsapi/card`
- Public query params: `slug` (string, required)
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /random — Random cards
- Gateway: `GET https://api.apiclay.com/v1/api/grandarchivetcgcardsapi/random`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

### GET /options — Filter options
- Gateway: `GET https://api.apiclay.com/v1/api/grandarchivetcgcardsapi/options`
- Upstream proxy: ApiClay proxy paid by the vendor (data cap 2 MB per call). Fetched through an ApiClay proxy paid by the vendor; a response larger than the route's data cap fails with 502 and is refunded in full.

## Call example

```bash
curl -X GET "https://api.apiclay.com/v1/api/grandarchivetcgcardsapi/search" \
  -H "token: <YOUR_APICLAY_TOKEN>"
```

Index of every published API: https://apiclay.com/llms.txt
