This section of the API documentation is dedicated to managing and accessing data related to individual cards within the Lorcana Trading Card Game. Featuring a couple of powerful endpoints, it enables developers and users to engage deeply with card-specific information.
id (string): A unique identifier for the card. This ID is used to reference the card within the API.name (string): The name of the card.version (string): A variant of the card, indicating a specific version or edition, if applicable.layout (string): Describes the card's layout. Currently either landscape (for Locations) or normal.released_at (string): The release date of the card in YYYY-MM-DD format.image_uris (object): Contains URLs to various sizes of the card's digital images. Each size (small, normal, large) is provided in AVIF format.
digital (object):
small (string): URL for a small-sized image of the card.normal (string): URL for a normal-sized image of the card.large (string): URL for a large-sized image of the card.cost (integer): The ink cost required to play the card.inkwell (boolean): Indicates whether the card can be inked.ink (string): Specifies the color of Ink for the card. If the card has no ink it will be null. Values will be one of:
type (string array): Lists the types assigned to the card (e.g., ["Action", "Song"]).classifications (string array | null): A list of classifications for Characters (e.g., ["Floodborn", "Hero", "Queen", "Sorcerer"]).text (string): Describes the card's abilities or rules text, formatted as plain text. This includes reminder text.move_cost (integer | null): The cost required to move a Character to a Location, if applicable.strength (integer | null): The strength attribute of the card.willpower (integer | null): The willpower attribute of the card.lore (integer | null): The lore attribute of the card, indicating its knowledge or wisdom.rarity (string): The rarity level of the card (e.g., "Enchanted").
illustrators (array of string): Names of the illustrators who created artwork for the card.collector_number (string): The card's number within its set. This value may not be an integer value.lang (string): The language code for the card (e.g., "en" for English).flavor_text (string | null): A narrative text providing background about the card, can be null if not applicable.tcgplayer_id (integer): An identifier used by TCGPlayer for linking to their platform.legalities (object): Contains information about the legality of the card in different game formats. The valid strings are legal, not_legal, and banned.
core (string): Legal status in the core format (e.g., "legal").set (object): Information about the set to which the card belongs.
id (string): Unique identifier for the set.code (string): A short code representing the set.name (string): The full name of the set.prices (object): Contains pricing information for the card in different conditions.
usd (string | null): The price in USD for the normal version of the card.usd_foil (string | null): The price in USD for a foil version of the card.The /cards/search endpoint allows users to perform full-text searches on the
card database using a query string that supports the full-text search
syntax the main site uses. This endpoint is designed to
facilitate complex queries to locate specific cards based on various attributes
and conditions.
This endpoint is not currently paginated, but in the future it will be.
q (string): The query string used for searching the card database. This
parameter supports a robust full-text search syntax allowing users to specify
conditions and attributes. Ensure that it is URL encoded.GET https://api.lorcast.com/v0/cards/search
curl https://api.lorcast.com/v0/cards/search?q=elsa+set:1+rarity:enchanted
{
"results": [
{
"id": "crd_cbc18e77d7ec4d50bf19650a9a559686",
"name": "Elsa",
"version": "Spirit of Winter",
"layout": "normal",
"released_at": "2023-08-18",
"image_uris": {
"digital": {
"small": "https://cards.lorcast.io/card/digital/small/crd_cbc18e77d7ec4d50bf19650a9a559686.avif?1709690747",
"normal": "https://cards.lorcast.io/card/digital/normal/crd_cbc18e77d7ec4d50bf19650a9a559686.avif?1709690747",
"large": "https://cards.lorcast.io/card/digital/large/crd_cbc18e77d7ec4d50bf19650a9a559686.avif?1709690747"
}
},
"cost": 8,
"inkwell": false,
"ink": "Amethyst",
"type": ["Character"],
"classifications": ["Floodborn", "Hero", "Queen", "Sorcerer"],
"text": "Shift 6 (You may pay 6 {I} to play this on top of one of your characters named Elsa.)\nDEEP FREEZE When you play this character, exert up to 2 chosen characters. They can't ready at the start of their next turn.",
"move_cost": null,
"strength": 4,
"willpower": 6,
"lore": 3,
"rarity": "Enchanted",
"illustrators": ["Matthew Robert Davies"],
"collector_number": "207",
"lang": "en",
"flavor_text": null,
"tcgplayer_id": 510153,
"legalities": {
"core": "legal"
},
"set": {
"id": "set_7ecb0e0c71af496a9e0110e23824e0a5",
"code": "1",
"name": "The First Chapter"
},
"prices": {
"usd": null,
"usd_foil": 1267.58
}
}
]
}
The /cards/:set/:number endpoint provides a method to retrieve a single card
by specifying its set identifier and collector number. This endpoint is designed
for precise lookups where the user knows the exact set and number of the card
they wish to query.
set (string): The identifier for the set to which the card belongs. This
should match the set's unique code or ID.number (string): The collector number of the card within its set. This
number identifies the card's position or sequence in the set.GET https://api.lorcast.com/v0/cards/:set/:number
curl https://api.lorcast.com/v0/cards/1/207
A successful request returns a single Card object. If no card matches the given set and number, a 404 error is returned.
{
"id": "crd_cbc18e77d7ec4d50bf19650a9a559686",
"name": "Elsa",
"version": "Spirit of Winter",
"layout": "normal",
"released_at": "2023-08-18",
"image_uris": {
"digital": {
"small": "https://cards.lorcast.io/card/digital/small/crd_cbc18e77d7ec4d50bf19650a9a559686.avif?1709690747",
"normal": "https://cards.lorcast.io/card/digital/normal/crd_cbc18e77d7ec4d50bf19650a9a559686.avif?1709690747",
"large": "https://cards.lorcast.io/card/digital/large/crd_cbc18e77d7ec4d50bf19650a9a559686.avif?1709690747"
}
},
"cost": 8,
"inkwell": false,
"ink": "Amethyst",
"type": ["Character"],
"classifications": ["Floodborn", "Hero", "Queen", "Sorcerer"],
"text": "Shift 6 (You may pay 6 {I} to play this on top of one of your characters named Elsa.)\nDEEP FREEZE When you play this character, exert up to 2 chosen characters. They can't ready at the start of their next turn.",
"move_cost": null,
"strength": 4,
"willpower": 6,
"lore": 3,
"rarity": "Enchanted",
"illustrators": ["Matthew Robert Davies"],
"collector_number": "207",
"lang": "en",
"flavor_text": null,
"tcgplayer_id": 510153,
"legalities": {
"core": "legal"
},
"set": {
"id": "set_7ecb0e0c71af496a9e0110e23824e0a5",
"code": "1",
"name": "The First Chapter"
},
"prices": {
"usd": null,
"usd_foil": 1267.58
}
}