Documentation

API Version 2

Introduction

This version of the API is currently in BETA. This means that all version 2.0 endpoints and/or payloads may change. This documentation will be updated when version 2.0 is stable and ready for production use. Please give feedback as I want to make this the way you want it! Send all feedback to: [email protected]

Set Information

Methods: GET, POST

Endpoint: http://api.mtgapi.com/v2/sets

Set Object:

Examples

// URL: http://api.mtgapi.com/v2/sets
{
    "query": null,
    "sets": [
        {...},
        {...},
        {
            "code": "ARB",
            "name": "Alara Reborn",
            "gathererCode": null,
            "oldCode": null,
            "symbolImages": {
                "common": "http://mtgimage.com/symbol/set/arb/c/128.png",
                "uncommon": "http://mtgimage.com/symbol/set/arb/u/128.png",
                "rare": "http://mtgimage.com/symbol/set/arb/r/128.png",
                "mythic": "http://mtgimage.com/symbol/set/arb/m/128.png",
                "special": null
            },
            "releaseDate": "2009-04-30",
            "border": "black",
            "type": "expansion",
            "block": "Alara",
            "onlineOnly": false,
            "cardCount": "145",
            "links": {
                "cards": "http://api.mtgapi.com/v2/cards?set=ARB",
                "booster": "http://api.mtgapi.com/v2/booster/ARB"
            }
        },
        {...},
        {...}
    ]
}

// URL: http://api.mtgapi.com/v2/sets?code=JOU
{
    "query": [
        {
            "command": "where",
            "key": "code",
            "conditional": "=",
            "value": "JOU"
        }
    ],
    "sets": [
        {
            "code": "JOU",
            "name": "Journey into Nyx",
            "gathererCode": null,
            "oldCode": null,
            "symbolImages": {
                "common": "http://mtgimage.com/symbol/set/jou/c/128.png",
                "uncommon": "http://mtgimage.com/symbol/set/jou/u/128.png",
                "rare": "http://mtgimage.com/symbol/set/jou/r/128.png",
                "mythic": "http://mtgimage.com/symbol/set/jou/m/128.png",
                "special": null
            },
            "releaseDate": "2014-05-02",
            "border": "black",
            "type": "expansion",
            "block": "Theros",
            "onlineOnly": false,
            "cardCount": "165",
            "links": {
                "cards": "http://api.mtgapi.com/v2/cards?set=JOU",
                "booster": "http://api.mtgapi.com/v2/booster/JOU"
            }
        }
    ]
}

Card Information

Methods: GET, POST

Endpoint: http://api.mtgapi.com/v2/cards

Card Object:

// LEFT OVERS to document / change
{
    "query": null,
    "total": 24782,
    "perPage": 20,
    "links": {
        "first": "http://api.mtgapi.com/v2/cards",
        "previous": null,
        "current": "http://api.mtgapi.com/v2/cards?page=1",
        "next": "http://api.mtgapi.com/v2/cards?page=2",
        "last": "http://api.mtgapi.com/v2/cards?page=1240"
    }
}

Card Names

Methods: GET, POST

Endpoint: http://api.mtgapi.com/v2/names

Information: Unique names array will be returned.

Booster Generator

Methods: GET, POST

Endpoint: http://api.mtgapi.com/v2/booster/lea

Information: One booster pack will be returned for each request.

API Version 1

List of Available Sets

Endpoint: http://api.mtgapi.com/v1/list/sets

This endpoint will return a list of all available sets that can be queried in the next endpoint.

List of Cards in a Set

Endpoint: http://api.mtgapi.com/v1/card/set/{set}

By giving a set from the previous endpoint, a list of all cards from that set will be generated.

List of Cards by Name

Endpoint: http://api.mtgapi.com/v1/card/name/{name}

This endpoint will return a list of cards that have the queried string in their name.

Cards by ID

Endpoint: http://api.mtgapi.com/v1/card/id/{id}