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

# Get Category Details

This endpoint returns an array of categories whose Ids were specified in the
categoryIds parameter.  Categories that could be found are returned in the results
array in the response.  Categories that could not be found are indicated in the
errors array.

This endpoint will return more information about a specific category or set of categories.

[block:code]
{
  "codes": [
    {
      "code": "{\n  \"success\": true,\n  \"errors\": [\n    \"string\"\n  ],\n  \"results\": [\n    {\n      \"categoryId\": 0,\n      \"name\": \"string\",\n      \"modifiedOn\": \"2017-11-21T00:47:27.070Z\",\n      \"displayName\": \"string\",\n      \"seoCategoryName\": \"string\",\n      \"sealedLabel\": \"string\",\n      \"nonSealedLabel\": \"string\",\n      \"conditionGuideUrl\": \"string\",\n      \"isScannable\": true,\n      \"popularity\": 0\n    }\n  ]\n}",
      "language": "json",
      "name": "Response Template"
    },
    {
      "code": "/catalog/categories/1,24\n\nHeaders:\nAuthorization | {{bearerToken}}\n\nResponse:\n{\n    \"success\": true,\n    \"errors\": [],\n    \"results\": [\n        {\n            \"categoryId\": 1,\n            \"name\": \"Magic\",\n            \"modifiedOn\": \"2019-03-05T14:28:55.687\",\n            \"displayName\": \"Magic: The Gathering\",\n            \"seoCategoryName\": \"Magic the Gathering TCG (MTG)\",\n            \"sealedLabel\": \"Sealed Products\",\n            \"nonSealedLabel\": \"Single Cards\",\n            \"conditionGuideUrl\": \"https://store.tcgplayer.com/conditions/magic.aspx\",\n            \"isScannable\": true,\n            \"popularity\": 7233794\n        },\n        {\n            \"categoryId\": 24,\n            \"name\": \"Final Fantasy TCG\",\n            \"modifiedOn\": \"2019-03-01T18:56:26.547\",\n            \"displayName\": \"Final Fantasy TCG\",\n            \"seoCategoryName\": \"Final Fantasy Trading Card Game\",\n            \"sealedLabel\": \"Sealed Products\",\n            \"nonSealedLabel\": \"Single Cards\",\n            \"conditionGuideUrl\": \"https://store.tcgplayer.com/\",\n            \"isScannable\": true,\n            \"popularity\": 14646\n        }\n    ]\n}",
      "language": "json",
      "name": "Examples Response #1"
    }
  ]
}
[/block]

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "v1.39.0",
    "title": "TcgApi"
  },
  "paths": {
    "/catalog/categories/{categoryIds}": {
      "get": {
        "tags": [
          "Catalog"
        ],
        "summary": "Get Category Details",
        "description": "This endpoint returns an array of categories whose Ids were specified in the\r\ncategoryIds parameter.  Categories that could be found are returned in the results\r\narray in the response.  Categories that could not be found are indicated in the\r\nerrors array.",
        "operationId": "Catalog_GetCategory",
        "parameters": [
          {
            "name": "categoryIds",
            "in": "path",
            "description": "A comma delimited list of Ids if the categories to be returned.",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "All categories found.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgApiModel.Common.ApiResult_TcgApiModel.Catalog.Category_"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgApiModel.Common.ApiResult_TcgApiModel.Catalog.Category_"
                }
              }
            }
          },
          "207": {
            "description": "Some categories found.  Those that were found are returned.  Those that were not\r\nare indicated by an error message.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgApiModel.Common.ApiResult_TcgApiModel.Catalog.Category_"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgApiModel.Common.ApiResult_TcgApiModel.Catalog.Category_"
                }
              }
            }
          },
          "404": {
            "description": "No categories found."
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.tcgplayer.com"
    }
  ],
  "components": {
    "schemas": {
      "TcgApiModel.Catalog.Category": {
        "type": "object",
        "properties": {
          "categoryId": {
            "format": "int32",
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "modifiedOn": {
            "format": "date-time",
            "type": "string"
          },
          "displayName": {
            "type": "string"
          },
          "seoCategoryName": {
            "type": "string"
          },
          "sealedLabel": {
            "type": "string"
          },
          "nonSealedLabel": {
            "type": "string"
          },
          "conditionGuideUrl": {
            "type": "string"
          },
          "isScannable": {
            "type": "boolean"
          },
          "popularity": {
            "format": "int32",
            "type": "integer"
          }
        }
      },
      "TcgApiModel.Common.ApiResult_TcgApiModel.Catalog.Category_": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "errors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TcgApiModel.Catalog.Category"
            }
          }
        }
      }
    }
  },
  "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
    }
  }
}
```