# Disney Lorcana TCG API
> Disney Lorcana trading-card game data as an API. Search and filter the full card pool by name, ink colour (Amber, Amethyst, Emerald, Ruby, Sapphire, Steel), card type, rarity, mana cost, set and classification; fetch a single card by its exact name; list every set; and list all the cards in a set. Each card returns its strength, willpower, lore value, inkable flag, abilities and body text, classifications (e.g. Hero, Dreamborn), the Disney franchise it comes from, the artist and the card artwork. Real data, no key needed upstream. Ideal for deck builders, collection trackers, price tools and Lorcana fan apps.

## Authentication
All requests require your oanor API key in the `x-oanor-key` header. Get one at https://www.oanor.com/developer/keys.

```bash
curl -H "x-oanor-key: oanor_live_…" "https://api.oanor.com/lorcana-api/..."
```

## Pricing
- **Free** (Free) — 11,000 calls/Mo, 2 req/s
- **Starter** ($4/Mo) — 140,000 calls/Mo, 8 req/s
- **Pro** ($16/Mo) — 720,000 calls/Mo, 25 req/s
- **Mega** ($59/Mo) — 3,300,000 calls/Mo, 50 req/s

## Endpoints

### Lorcana

#### `GET /v1/card` — A single card by exact name

**Parameters:**
- `name` (query, required, string) — Exact card name Example: `Mickey Mouse - Brave Little Tailor`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/lorcana-api/v1/card?name=Mickey+Mouse+-+Brave+Little+Tailor"
```

**Response:**
```json
{
    "data": {
        "card": {
            "cost": 8,
            "lore": 4,
            "name": "Mickey Mouse - Brave Little Tailor",
            "type": "Character",
            "color": "Ruby",
            "image": "https://lorcana-api.com/images/mickey_mouse/brave_little_tailor/mickey_mouse-brave_little_tailor-large.png",
            "artist": "Nicolas Kole",
            "rarity": "Legendary",
            "inkable": true,
            "set_num": 1,
            "card_num": 115,
            "set_name": "The First Chapter",
            "strength": 5,
            "abilities": "Evasive",
            "body_text": "Evasive (Only characters with Evasive can challenge this character.)",
            "franchise": "",
            "unique_id": "TFC-115",
            "willpower": 5,
            "flavor_text": "When defeat looms and victory hangs by a thread, a hero bolts to the rescue, patching things up through shear determination.",
            "classifications": [
                "Dreamborn",
                "Hero"
            ]
        }
    },
    "meta": {
        "timestamp": "2026-06-08T01:19:34.753Z",
        "request_id": "5a86cb38-f5ea-49ed-b6dc-33f2b4bdb4fb"
    },
    "status": "ok",
    "message": "Card retrieved successfully",
    "success": true
}
```

#### `GET /v1/search` — Search & filter cards

**Parameters:**
- `name` (query, optional, string) — Name contains, e.g. Elsa Example: `Elsa`
- `color` (query, optional, string) — Ink colour (Amber, Amethyst, Emerald, Ruby, Sapphire, Steel)
- `type` (query, optional, string) — Card type, e.g. Character
- `rarity` (query, optional, string) — Rarity, e.g. Legendary
- `cost` (query, optional, string) — Exact mana cost
- `set` (query, optional, string) — Set name
- `q` (query, optional, string) — Raw lorcana-api search expression
- `limit` (query, optional, string) — Page size (default 60) Example: `60`
- `page` (query, optional, string) — Page number Example: `1`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/lorcana-api/v1/search?name=Elsa&limit=60&page=1"
```

**Response:**
```json
{
    "data": {
        "cards": [
            {
                "cost": 2,
                "lore": 1,
                "name": "Elsa - Trusted Sister",
                "type": "Character",
                "color": "Amethyst",
                "image": "https://lorcana-api.com/images/elsa/trusted_sister/elsa-trusted_sister-large.png",
                "artist": "Amber Kommavongsa",
                "rarity": "Common",
                "inkable": true,
                "set_num": 7,
                "card_num": 55,
                "set_name": "Archazia's Island",
                "strength": 2,
                "body_text": "WHAT DO WE DO NOW? Whenever this character quests, if you have a character named Anna in play, gain 1 lore.",
                "franchise": "Frozen",
                "unique_id": "ARI-055",
                "willpower": 3,
                "flavor_text": "\"Fear is what can't be trusted.\"",
                "classifications": [
                    "Storyborn",
                    "Hero",
                    "Queen",
                    "Sorcerer"
                ]
            },
            {
                "cost": 7,
                "lore": 2,
                "name": "Elsa - Ice Maker",
                "type": "Character",
                "color": "Amethyst, Sapphire",
                "image": "https://lorcana-api.com/images/elsa/ice_maker/elsa-ice_maker-large.png",
                "artist": "lan MacDonald",
                "rarity": "Super Rare",
                "i
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/set` — Cards in a set

**Parameters:**
- `set` (query, required, string) — Set name, e.g. The First Chapter Example: `The First Chapter`
- `limit` (query, optional, string) — Page size Example: `60`

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/lorcana-api/v1/set?set=The+First+Chapter&limit=60"
```

**Response:**
```json
{
    "data": {
        "set": "The First Chapter",
        "cards": [
            {
                "cost": 4,
                "lore": 2,
                "name": "Ariel - On Human Legs",
                "type": "Character",
                "color": "Amber",
                "image": "https://lorcana-api.com/images/ariel/on_human_legs/ariel-on_human_legs-large.png",
                "artist": "Matthew Robert Davies",
                "rarity": "Uncommon",
                "inkable": true,
                "set_num": 1,
                "card_num": 1,
                "set_name": "The First Chapter",
                "strength": 3,
                "body_text": "Voiceless - This character can't {e} to sing songs.",
                "franchise": "",
                "unique_id": "TFC-001",
                "willpower": 4,
                "flavor_text": "\"...\"",
                "classifications": [
                    "Storyborn",
                    "Hero",
                    "Princess"
                ]
            },
            {
                "cost": 3,
                "lore": 1,
                "name": "Ariel - Spectacular Singer",
                "type": "Character",
                "color": "Amber",
                "image": "https://lorcana-api.com/images/ariel/spectacular_singer/ariel-spectacular_singer-large.png",
                "artist": "Alice Pisoni",
                "rarity": "Super Rare",
                "inkable": true,
                "set_num": 1,
                "ca
…(truncated, see openapi.json for full schema)
```

#### `GET /v1/sets` — All Lorcana sets

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/lorcana-api/v1/sets"
```

**Response:**
```json
{
    "data": {
        "sets": [
            {
                "name": "Archazia's Island",
                "set_id": "ARI",
                "set_num": 7,
                "released": "2025-03-07",
                "total_cards": null
            },
            {
                "name": "Azurite Sea",
                "set_id": "AZS",
                "set_num": 6,
                "released": "2024-11-15",
                "total_cards": null
            },
            {
                "name": "Fabled",
                "set_id": "FAB",
                "set_num": 9,
                "released": "2025-08-29",
                "total_cards": null
            },
            {
                "name": "Into the Inklands",
                "set_id": "INK",
                "set_num": 3,
                "released": "2024-02-23",
                "total_cards": null
            },
            {
                "name": "Illumineer's Quest: Deep Trouble",
                "set_id": "QU1",
                "set_num": 4,
                "released": "2024-05-17",
                "total_cards": null
            },
            {
                "name": "Rise of The Floodborn",
                "set_id": "ROF",
                "set_num": 2,
                "released": "2023-11-17",
                "total_cards": null
            },
            {
                "name": "Reign of Jafar",
                "set_id": "ROJ",
                "set_num": 8,
                "released": "2025-05-30",
             
…(truncated, see openapi.json for full schema)
```

### Meta

#### `GET /v1/meta` — Service description & endpoints

**Example:**
```bash
curl -H "x-oanor-key: $KEY" \
  "https://api.oanor.com/lorcana-api/v1/meta"
```

**Response:**
```json
{
    "data": {
        "colors": [
            "Amber",
            "Amethyst",
            "Emerald",
            "Ruby",
            "Sapphire",
            "Steel"
        ],
        "service": "lorcana-api",
        "rarities": [
            "Common",
            "Uncommon",
            "Rare",
            "Super Rare",
            "Legendary",
            "Enchanted",
            "Promo"
        ],
        "endpoints": {
            "GET /v1/set": "Cards in a set (set=).",
            "GET /v1/card": "A single card by exact name (name=).",
            "GET /v1/meta": "This document.",
            "GET /v1/sets": "All Lorcana sets.",
            "GET /v1/search": "Search/filter cards (name=, color=, type=, rarity=, set=, cost=, q=, page=, limit=)."
        },
        "description": "Disney Lorcana TCG card data via lorcana-api.com: search and filter the full card pool by name, colour/ink, type, rarity, cost, set and classification; fetch a single card by exact name; list the sets; and list the cards in a set. Each card includes its strength, willpower, lore, abilities, classifications, artwork and set. Real data, no key."
    },
    "meta": {
        "timestamp": "2026-06-08T01:19:38.978Z",
        "request_id": "db963bca-d622-4261-a825-a5c6ed988c0f"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}
```


---
Marketplace page: https://www.oanor.com/api/lorcana-api
OpenAPI spec: https://www.oanor.com/api/lorcana-api/openapi.json