Skip to content
oanor
Sign up free
Marketplace Pricing Features Sign in
GET /v1/card

A card by name (exact, then fuzzy)

Try it live

10 free calls per day — no sign-up, no API key. Goes through the oanor gateway.

Custom headers (optional)
api.oanor.com/mtg-api

It works. Grab an API key and use it in your project.

Get an API key

Code snippets

curl "https://api.oanor.com/mtg-api/v1/card" \
  -H "x-oanor-key: oanor_test_..."
await fetch("https://api.oanor.com/mtg-api/v1/card", {
  headers: { "x-oanor-key": "oanor_test_..." }
});
$ch = curl_init("https://api.oanor.com/mtg-api/v1/card");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);
import requests
requests.get(
    "https://api.oanor.com/mtg-api/v1/card",
    headers={"x-oanor-key": "oanor_test_..."}
)

Example response

A real response from this endpoint, captured by the latest health check.

{
    "data": {
        "card": {
            "id": "bd8fa327-dd41-4737-8f19-2cf5eb1f7cdd",
            "cmc": 0,
            "set": "vma",
            "name": "Black Lotus",
            "image": "https://cards.scryfall.io/normal/front/b/d/bd8fa327-dd41-4737-8f19-2cf5eb1f7cdd.jpg?1614638838",
            "power": null,
            "artist": "Chris Rahn",
            "colors": [],
            "prices": {
                "eur": null,
                "tix": "75.20",
                "usd": null,
                "eur_foil": null,
                "usd_foil": null,
                "usd_etched": null
            },
            "rarity": "bonus",
            "loyalty": null,
            "keywords": [],
            "set_name": "Vintage Masters",
            "mana_cost": "{0}",
            "toughness": null,
            "type_line": "Artifact",
            "legalities": {
                "tlr": "banned",
                "duel": "banned",
                "brawl": "not_legal",
                "penny": "not_legal",
                "predh": "banned",
                "future": "not_legal",
                "legacy": "banned",
                "modern": "not_legal",
                "pauper": "not_legal",
                "alchemy": "not_legal",
                "pioneer": "not_legal",
                "vintage": "restricted",
                "historic": "not_legal",
                "standard": "not_legal",
                "timeless": "not_legal",
                "commander": "banned",
                "gladiator": "not_legal",
                "oldschool": "not_legal",
                "premodern": "not_legal",
                "oathbreaker": "banned",
                "standardbrawl": "not_legal",
                "paupercommander": "not_legal"
            },
            "oracle_text": "{T}, Sacrifice this artifact: Add three mana of any one color.",
            "released_at": "2014-06-16",
            "scryfall_uri": "https://scryfall.com/card/vma/4/black-lotus?utm_source=api",
            "color_identity": [],
            "collector_number": "4"
        }
    },
    "meta": {
        "timestamp": "2026-06-01T00:04:42.440Z",
        "request_id": "2b1cda1b-aa99-49d7-9578-284c7bfe2632"
    },
    "status": "ok",
    "message": "Card retrieved",
    "success": true
}