GET /symbology/parse-mana

Supported formats: json

Parses the given mana cost parameter and returns Scryfall’s interpretation.

The server understands most community shorthand for mana costs (such as 2WW for {2}{W}{W}). Symbols can also be out of order, lowercase, or have multiple colorless costs (such as 2{g}2 for {4}{G}).

If part of the string could not be understood, the server will return an Error object describing the problem.

Parameter Type Atn Details
cost String The mana string to parse.
format String Optional The data format to return. This method only supports json.
pretty Boolean Optional If true, the returned JSON will be prettified. Avoid using for production code.

Returned Properties

The returned object will have the following properties:

Property Type Atn Details
cost String The normalized cost, with correctly-ordered and wrapped mana symbols.
cmc Decimal The converted mana cost. If you submit Un-set mana symbols, this decimal could include fractional parts.
colors Colors The colors of the given cost.
colorless Boolean True if the cost is colorless.
monocolored Boolean True if the cost is monocolored.
multicolored Boolean True if the cost is multicolored.

Example Request

Parse the mana string “RUx”

GET https://api.scryfall.com/symbology/parse-mana?cost=RUx