Scryfall Catalogs API

Convenience lists of Magic data points (card names, types, supertypes, etc.).

Operations 17

GET /catalog/card-names Catalog of Card Names #
GET /catalog/artist-names Catalog of Artist Names #
GET /catalog/word-bank Catalog of Word Bank #
GET /catalog/creature-types Catalog of Creature Types #
GET /catalog/planeswalker-types Catalog of Planeswalker Types #
GET /catalog/land-types Catalog of Land Types #
GET /catalog/artifact-types Catalog of Artifact Types #
GET /catalog/enchantment-types Catalog of Enchantment Types #
GET /catalog/spell-types Catalog of Spell Types #
GET /catalog/powers Catalog of Powers #
GET /catalog/toughnesses Catalog of Toughnesses #
GET /catalog/loyalties Catalog of Loyalties #
GET /catalog/keyword-abilities Catalog of Keyword Abilities #
GET /catalog/keyword-actions Catalog of Keyword Actions #
GET /catalog/ability-words Catalog of Ability Words #
GET /catalog/watermarks Catalog of Watermarks #
GET /catalog/supertypes Catalog of Card Supertypes #

Documentation

Specifications

Schemas & Data

📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-schema/scryfall-card-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-schema/scryfall-card-face-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-schema/scryfall-related-card-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-schema/scryfall-image-uris-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-schema/scryfall-legalities-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-schema/scryfall-prices-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-schema/scryfall-set-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-schema/scryfall-ruling-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-schema/scryfall-card-symbol-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-schema/scryfall-catalog-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-schema/scryfall-bulk-data-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-schema/scryfall-migration-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-schema/scryfall-list-schema.json
📊
JSONSchema
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-schema/scryfall-error-schema.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-structure/scryfall-card-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-structure/scryfall-set-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-structure/scryfall-ruling-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-structure/scryfall-card-symbol-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-structure/scryfall-catalog-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-structure/scryfall-bulk-data-structure.json
📊
JSONStructure
https://raw.githubusercontent.com/api-evangelist/scryfall/refs/heads/main/json-structure/scryfall-migration-structure.json

Other Resources

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/scryfall-catalogs-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

scryfall-catalogs-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Scryfall Catalogs API
  description: 'The Scryfall API is a REST-like interface to the most comprehensive Magic: The Gathering

    card database.'
  version: '2026-05-29'
  contact:
    name: Scryfall API Support
    url: https://scryfall.com/contact
  license:
    name: Scryfall API License (Free with attribution)
    url: https://scryfall.com/docs/api
  termsOfService: https://scryfall.com/docs/api
servers:
- url: https://api.scryfall.com
  description: Production API
tags:
- name: Catalogs
  description: Convenience lists of Magic data points (card names, types, supertypes, etc.).
paths:
  /catalog/card-names:
    get:
      tags:
      - Catalogs
      summary: Catalog of Card Names
      description: Returns a Catalog of every canonical English card name in Scryfall's database.
      operationId: catalogCardNames
      responses:
        '200':
          description: A catalog of card names.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
  /catalog/artist-names:
    get:
      tags:
      - Catalogs
      summary: Catalog of Artist Names
      description: Returns a Catalog of every artist who has illustrated a Magic card.
      operationId: catalogArtistNames
      responses:
        '200':
          description: A catalog of artist names.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
  /catalog/word-bank:
    get:
      tags:
      - Catalogs
      summary: Catalog of Word Bank
      description: Returns a Catalog of every distinct word in card names.
      operationId: catalogWordBank
      responses:
        '200':
          description: A catalog of words.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
  /catalog/creature-types:
    get:
      tags:
      - Catalogs
      summary: Catalog of Creature Types
      description: Returns a Catalog of all creature types in Magic.
      operationId: catalogCreatureTypes
      responses:
        '200':
          description: A catalog of creature types.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
  /catalog/planeswalker-types:
    get:
      tags:
      - Catalogs
      summary: Catalog of Planeswalker Types
      description: Returns a Catalog of all planeswalker subtypes.
      operationId: catalogPlaneswalkerTypes
      responses:
        '200':
          description: A catalog of planeswalker types.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
  /catalog/land-types:
    get:
      tags:
      - Catalogs
      summary: Catalog of Land Types
      description: Returns a Catalog of all land subtypes.
      operationId: catalogLandTypes
      responses:
        '200':
          description: A catalog of land types.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
  /catalog/artifact-types:
    get:
      tags:
      - Catalogs
      summary: Catalog of Artifact Types
      description: Returns a Catalog of all artifact subtypes.
      operationId: catalogArtifactTypes
      responses:
        '200':
          description: A catalog of artifact types.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
  /catalog/enchantment-types:
    get:
      tags:
      - Catalogs
      summary: Catalog of Enchantment Types
      description: Returns a Catalog of all enchantment subtypes.
      operationId: catalogEnchantmentTypes
      responses:
        '200':
          description: A catalog of enchantment types.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
  /catalog/spell-types:
    get:
      tags:
      - Catalogs
      summary: Catalog of Spell Types
      description: Returns a Catalog of all spell subtypes.
      operationId: catalogSpellTypes
      responses:
        '200':
          description: A catalog of spell types.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
  /catalog/powers:
    get:
      tags:
      - Catalogs
      summary: Catalog of Powers
      description: Returns a Catalog of all power values on creature cards.
      operationId: catalogPowers
      responses:
        '200':
          description: A catalog of power values.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
  /catalog/toughnesses:
    get:
      tags:
      - Catalogs
      summary: Catalog of Toughnesses
      description: Returns a Catalog of all toughness values on creature cards.
      operationId: catalogToughnesses
      responses:
        '200':
          description: A catalog of toughness values.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
  /catalog/loyalties:
    get:
      tags:
      - Catalogs
      summary: Catalog of Loyalties
      description: Returns a Catalog of all loyalty values on planeswalker cards.
      operationId: catalogLoyalties
      responses:
        '200':
          description: A catalog of loyalty values.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
  /catalog/keyword-abilities:
    get:
      tags:
      - Catalogs
      summary: Catalog of Keyword Abilities
      description: Returns a Catalog of all keyword abilities Magic cards may have.
      operationId: catalogKeywordAbilities
      responses:
        '200':
          description: A catalog of keyword abilities.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
  /catalog/keyword-actions:
    get:
      tags:
      - Catalogs
      summary: Catalog of Keyword Actions
      description: Returns a Catalog of all keyword actions in Magic.
      operationId: catalogKeywordActions
      responses:
        '200':
          description: A catalog of keyword actions.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
  /catalog/ability-words:
    get:
      tags:
      - Catalogs
      summary: Catalog of Ability Words
      description: Returns a Catalog of all ability words on Magic cards.
      operationId: catalogAbilityWords
      responses:
        '200':
          description: A catalog of ability words.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
  /catalog/watermarks:
    get:
      tags:
      - Catalogs
      summary: Catalog of Watermarks
      description: Returns a Catalog of all distinct illustration watermarks used on Magic cards.
      operationId: catalogWatermarks
      responses:
        '200':
          description: A catalog of watermarks.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
  /catalog/supertypes:
    get:
      tags:
      - Catalogs
      summary: Catalog of Card Supertypes
      description: Returns a Catalog of card supertypes (e.g., Basic, Legendary, Snow, World).
      operationId: catalogSupertypes
      responses:
        '200':
          description: A catalog of supertypes.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Catalog'
components:
  schemas:
    Catalog:
      type: object
      description: A Scryfall Catalog object containing an array of Magic datapoints (names, types, etc.).
      properties:
        object:
          type: string
          enum:
          - catalog
        uri:
          type: string
          format: uri
        total_values:
          type: integer
        data:
          type: array
          items:
            type: string