Fetch the complete documentation index at: https://docs.tcgplayer.com/llms.txt. Use this file to discover all available pages before exploring further.

# List All Category Rarities

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

[block:callout]
{
  "type": "info",
  "title": "Helpful note!",
  "body": "Depending on application needs, this data may also be found through the search manifest:\nhttp://api.tcgplayer.com/v1.8.0/catalog/categories/{categoryId}/search/manifest\n\nThis 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."
}
[/block]

[block:code]
{
  "codes": [
    {
      "code": "{\n    \"success\": true,\n    \"errors\": [],\n    \"results\": [\n        {\n            \"rarityId\": integer,\n            \"displayText\": \"string\",\n            \"dbValue\": \"string\"\n        },\n        {\n            \"rarityId\": integer,\n            \"displayText\": \"string\",\n            \"dbValue\": \"string\"\n        },\n        {\n            \"rarityId\": integer,\n            \"displayText\": \"string\",\n            \"dbValue\": \"string\"\n        }\n    ]\n}",
      "language": "json",
      "name": "Response Template"
    },
    {
      "code": "/catalog/categories/1/rarities\n\n{\n    \"success\": true,\n    \"errors\": [],\n    \"results\": [\n        {\n            \"rarityId\": 3,\n            \"displayText\": \"Uncommon\",\n            \"dbValue\": \"U\"\n        },\n        {\n            \"rarityId\": 108,\n            \"displayText\": \"Token\",\n            \"dbValue\": \"T\"\n        },\n        {\n            \"rarityId\": 111,\n            \"displayText\": \"Special\",\n            \"dbValue\": \"S\"\n        },\n        {\n            \"rarityId\": 2,\n            \"displayText\": \"Rare\",\n            \"dbValue\": \"R\"\n        },\n        {\n            \"rarityId\": 5,\n            \"displayText\": \"Promo\",\n            \"dbValue\": \"P\"\n        },\n        {\n            \"rarityId\": 1,\n            \"displayText\": \"Mythic\",\n            \"dbValue\": \"M\"\n        },\n        {\n            \"rarityId\": 107,\n            \"displayText\": \"Land\",\n            \"dbValue\": \"L\"\n        },\n        {\n            \"rarityId\": 4,\n            \"displayText\": \"Common\",\n            \"dbValue\": \"C\"\n        }\n    ]\n}",
      "language": "json",
      "name": "Example Response #1"
    },
    {
      "code": "/catalog/categories/3/rarities\n\n{\n    \"success\": true,\n    \"errors\": [],\n    \"results\": [\n        {\n            \"rarityId\": 73,\n            \"displayText\": \"Uncommon\",\n            \"dbValue\": \"Uncommon\"\n        },\n        {\n            \"rarityId\": 72,\n            \"displayText\": \"Ultra Rare\",\n            \"dbValue\": \"Ultra Rare\"\n        },\n        {\n            \"rarityId\": 71,\n            \"displayText\": \"Secret Rare\",\n            \"dbValue\": \"Secret Rare\"\n        },\n        {\n            \"rarityId\": 70,\n            \"displayText\": \"Rare\",\n            \"dbValue\": \"Rare\"\n        },\n        {\n            \"rarityId\": 69,\n            \"displayText\": \"Holo Rare\",\n            \"dbValue\": \"Holo Rare\"\n        },\n        {\n            \"rarityId\": 68,\n            \"displayText\": \"Common\",\n            \"dbValue\": \"Common\"\n        }\n    ]\n}",
      "language": "json",
      "name": "Example Response #2"
    }
  ]
}
[/block]

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "v1.39.0",
    "title": "TcgApi"
  },
  "paths": {
    "/catalog/categories/{categoryId}/rarities": {
      "get": {
        "tags": [
          "Catalog"
        ],
        "summary": "List All Category Rarities",
        "description": "This endpoint returns all available rarities associated with the specified category.",
        "operationId": "Catalog_GetCategoryRarities",
        "parameters": [
          {
            "name": "categoryId",
            "in": "path",
            "description": "The Id of the category whose rarities should be returned.",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Category found and rarities returned.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgApiModel.Common.ApiResult_TcgApiModel.Catalog.Rarity_"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgApiModel.Common.ApiResult_TcgApiModel.Catalog.Rarity_"
                }
              }
            }
          },
          "400": {
            "description": "CategoryId is less than or equal to 0."
          },
          "404": {
            "description": "Category could not be found or no rarities found."
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.tcgplayer.com"
    }
  ],
  "components": {
    "schemas": {
      "TcgApiModel.Catalog.Rarity": {
        "type": "object",
        "properties": {
          "rarityId": {
            "format": "int32",
            "type": "integer"
          },
          "displayText": {
            "type": "string"
          },
          "dbValue": {
            "type": "string"
          }
        }
      },
      "TcgApiModel.Common.ApiResult_TcgApiModel.Catalog.Rarity_": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "errors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TcgApiModel.Catalog.Rarity"
            }
          }
        }
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  },
  "_id": {
    "buffer": {
      "0": 94,
      "1": 217,
      "2": 152,
      "3": 86,
      "4": 78,
      "5": 118,
      "6": 200,
      "7": 0,
      "8": 17,
      "9": 105,
      "10": 157,
      "11": 192
    }
  }
}
```