What is Riftcodex?
Riftcodex is an open REST API for Riftbound, Riot Games' trading card game. It provides comprehensive access to card data, set information, and search functionality, all without requiring an API key.
What's Available
The API currently offers:
- Card endpoints — Browse and search for cards
- Set endpoints — List all sets and their details
- Index endpoints — Get lists of various card attributes
Getting started
The documentation pages contain detailed information on all available endpoints, request models, response models and example requests.
Fetching cards is as simple as:
curl "https://api.riftcodex.com/cards?size=1"Response:
JSON
{
"items": [
{
"id": "69a63387829d03360413d711",
"name": "Trove Golem",
"riftbound_id": "sfd-174-221",
"tcgplayer_id": "666485",
"collector_number": 174,
"attributes": {
"energy": 8,
"might": 9,
"power": 2
},
"classification": {
"type": "Unit",
"supertype": null,
"rarity": "Rare",
"domain": [
"Order"
]
},
"text": {
"rich": "<p>When you play me, play four Gold gear tokens exhausted.</p>",
"plain": "When you play me, play four Gold gear tokens exhausted.",
"flavour": "As expensive as it is expansive."
},
"set": {
"set_id": "SFD",
"label": "Spiritforged"
},
"media": {
"image_url": "https://cmsassets.rgpub.io/sanity/images/dsfx7636/game_data_live/e5b0966cc00203db1036b6fa95360541f72ae131-744x1039.png",
"artist": "Envar Studio",
"accessibility_text": "Riftbound Unit: Trove Golem. When you play me, play four Gold gear tokens exhausted."
},
"tags": [
"Freljord"
],
"orientation": "portrait",
"metadata": {
"clean_name": "Trove Golem",
"updated_on": "2026-03-16T17:51:01.063941+00:00",
"alternate_art": false,
"overnumbered": false,
"signature": false
}
}
],
"total": 772,
"page": 1,
"size": 1,
"pages": 772
}We can also filter cards by set:
curl "https://api.riftcodex.com/cards?set_id=SFD&size=1"And here's an example of searching for a specific card by name:
curl "https://api.riftcodex.com/cards/name?fuzzy=yi+honed&set_id=ogs"Response:
JSON
{
"items": [
{
"id": "69a6337e829d03360413d672",
"name": "Master Yi - Honed",
"riftbound_id": "ogs-009-024",
"tcgplayer_id": "653144",
"collector_number": 9,
"attributes": {
"energy": 7,
"might": 6,
"power": 1
},
"classification": {
"type": "Unit",
"supertype": "Champion",
"rarity": "Epic",
"domain": [
"Body"
]
},
"text": {
"rich": "<p>[Ganking] (I can move from battlefield to battlefield.)<br />I enter ready.</p>",
"plain": "[Ganking] (I can move from battlefield to battlefield.)I enter ready.",
"flavour": "The focused mind can pierce through stone."
},
"set": {
"set_id": "OGS",
"label": "Proving Grounds"
},
"media": {
"image_url": "https://cmsassets.rgpub.io/sanity/images/dsfx7636/game_data_live/0e16976cd6d7ee5a874be9351b428671990fbd25-744x1039.png",
"artist": "Kudos Productions",
"accessibility_text": "Riftbound Unit: Yi, Honed. [Ganking] (I can move from battlefield to battlefield.)\nI enter ready."
},
"tags": [
"Master Yi",
"Ionia"
],
"orientation": "portrait",
"metadata": {
"clean_name": "Master Yi Honed",
"updated_on": "2026-03-16T17:50:52.780266+00:00",
"alternate_art": false,
"overnumbered": false,
"signature": false
}
},
{
"id": "69a6337e829d03360413d66d",
"name": "Master Yi - Meditative",
"riftbound_id": "ogs-004-024",
"tcgplayer_id": "653139",
"collector_number": 4,
"attributes": {
"energy": 5,
"might": 4,
"power": 1
},
"classification": {
"type": "Unit",
"supertype": "Champion",
"rarity": "Rare",
"domain": [
"Calm"
]
},
"text": {
"rich": "<p>While you have 8+ runes, I have +4 :rb_might:.</p>",
"plain": "While you have 8+ runes, I have +4 :rb_might:.",
"flavour": "Anger gives motivation without purpose."
},
"set": {
"set_id": "OGS",
"label": "Proving Grounds"
},
"media": {
"image_url": "https://cmsassets.rgpub.io/sanity/images/dsfx7636/game_data_live/5508566c8f05f09492148faa803332a731095eb7-744x1039.png",
"artist": "Kudos Productions",
"accessibility_text": "Riftbound Unit: Yi, Meditative. While you have 8+ runes, I have +4 [S]."
},
"tags": [
"Master Yi",
"Ionia"
],
"orientation": "portrait",
"metadata": {
"clean_name": "Master Yi Meditative",
"updated_on": "2026-03-16T17:50:52.534257+00:00",
"alternate_art": false,
"overnumbered": false,
"signature": false
}
},
{
"id": "69a6337f829d03360413d67c",
"name": "Master Yi - Wuju Bladesman (Starter)",
"riftbound_id": "ogs-019-024",
"tcgplayer_id": "653154",
"collector_number": 19,
"attributes": {
"energy": null,
"might": null,
"power": null
},
"classification": {
"type": "Legend",
"supertype": "Champion",
"rarity": "Rare",
"domain": [
"Calm",
"Body"
]
},
"text": {
"rich": "<p>While a friendly unit defends alone, it gets +2 :rb_might:.</p>",
"plain": "While a friendly unit defends alone, it gets +2 :rb_might:.",
"flavour": null
},
"set": {
"set_id": "OGS",
"label": "Proving Grounds"
},
"media": {
"image_url": "https://cmsassets.rgpub.io/sanity/images/dsfx7636/game_data_live/8231ced23eaf22ca3bf62ec8cb86b83a3e222da6-744x1039.png",
"artist": "Grafit Studio/Quy Ho",
"accessibility_text": "Riftbound Legend: Wuju Bladesman - Starter. While a friendly unit defends alone, it gets +2 [S]."
},
"tags": [
"Master Yi"
],
"orientation": "portrait",
"metadata": {
"clean_name": "Master Yi Wuju Bladesman Starter",
"updated_on": "2026-03-16T17:50:53.301460+00:00",
"alternate_art": false,
"overnumbered": false,
"signature": false
}
}
],
"total": 3,
"page": 1,
"size": 50,
"pages": 1
}Conlcusion
And that's it for now! It's still very early days at the moment, so please bear with us as we iron out any bugs. Always happy to hear any suggestions for improvements or new features too at support@riftcodex.com