HomeGuidesAPI Endpoints
GuidesAPI EndpointsCommunityLog In

List All Category Rarities

This endpoint returns all available rarities associated with the specified category.

📘

Helpful note!

Depending on application needs, this data may also be found through the search manifest:
http://api.tcgplayer.com/v1.8.0/catalog/categories/{categoryId}/search/manifest

This endpoint only contains data about rarities. The manifest returns a whole treasure trove of data about a category. This endpoint is great if you need a precision tool instead of a whole hammer.

{
    "success": true,
    "errors": [],
    "results": [
        {
            "rarityId": integer,
            "displayText": "string",
            "dbValue": "string"
        },
        {
            "rarityId": integer,
            "displayText": "string",
            "dbValue": "string"
        },
        {
            "rarityId": integer,
            "displayText": "string",
            "dbValue": "string"
        }
    ]
}
/catalog/categories/1/rarities

{
    "success": true,
    "errors": [],
    "results": [
        {
            "rarityId": 3,
            "displayText": "Uncommon",
            "dbValue": "U"
        },
        {
            "rarityId": 108,
            "displayText": "Token",
            "dbValue": "T"
        },
        {
            "rarityId": 111,
            "displayText": "Special",
            "dbValue": "S"
        },
        {
            "rarityId": 2,
            "displayText": "Rare",
            "dbValue": "R"
        },
        {
            "rarityId": 5,
            "displayText": "Promo",
            "dbValue": "P"
        },
        {
            "rarityId": 1,
            "displayText": "Mythic",
            "dbValue": "M"
        },
        {
            "rarityId": 107,
            "displayText": "Land",
            "dbValue": "L"
        },
        {
            "rarityId": 4,
            "displayText": "Common",
            "dbValue": "C"
        }
    ]
}
/catalog/categories/3/rarities

{
    "success": true,
    "errors": [],
    "results": [
        {
            "rarityId": 73,
            "displayText": "Uncommon",
            "dbValue": "Uncommon"
        },
        {
            "rarityId": 72,
            "displayText": "Ultra Rare",
            "dbValue": "Ultra Rare"
        },
        {
            "rarityId": 71,
            "displayText": "Secret Rare",
            "dbValue": "Secret Rare"
        },
        {
            "rarityId": 70,
            "displayText": "Rare",
            "dbValue": "Rare"
        },
        {
            "rarityId": 69,
            "displayText": "Holo Rare",
            "dbValue": "Holo Rare"
        },
        {
            "rarityId": 68,
            "displayText": "Common",
            "dbValue": "Common"
        }
    ]
}
Language
Click Try It! to start a request and see the response here!