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 Groups

This endpoint returns a paged list of all the groups associated with the specified
category.

Groups are also commonly referred to as sets, though this varies by product.

[block:code]
{
  "codes": [
    {
      "code": "{\n  \"totalItems\": 0,\n  \"success\": true,\n  \"errors\": [\n    \"string\"\n  ],\n  \"results\": [\n    {\n      \"groupId\": 0,\n      \"name\": \"string\",\n      \"abbreviation\": \"string\",\n      \"isSupplemental\": true,\n      \"publishedOn\": \"string\",\n      \"modifiedOn\": \"2017-11-21T00:47:27.120Z\"\n      \"categoryId\": 0\n    }\n  ]\n}",
      "language": "json",
      "name": "Response Template"
    },
    {
      "code": "/catalog/categories/1/groups?offset=37&limit=2\n\nHeaders:\nAuthorization | {{bearerToken}}\n\n{\n    \"totalItems\": 237,\n    \"success\": true,\n    \"errors\": [],\n    \"results\": [\n        {\n            \"groupId\": 1882,\n            \"name\": \"Amonkhet\",\n            \"abbreviation\": \"AKH\",\n            \"isSupplemental\": false,\n            \"publishedOn\": \"2017-04-28T00:00:00\",\n            \"modifiedOn\": \"2019-03-04T16:29:17.31\",\n            \"categoryId\": 1\n        },\n        {\n            \"groupId\": 1909,\n            \"name\": \"Masterpiece Series: Amonkhet Invocations\",\n            \"abbreviation\": \"MPS2\",\n            \"isSupplemental\": true,\n            \"publishedOn\": \"2017-04-28T00:00:00\",\n            \"modifiedOn\": \"2019-02-08T19:05:35.467\",\n            \"categoryId\": 1\n        }\n    ]\n}",
      "language": "json",
      "name": "Example Response #1"
    }
  ]
}
[/block]

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "v1.39.0",
    "title": "TcgApi"
  },
  "paths": {
    "/catalog/categories/{categoryId}/groups": {
      "get": {
        "tags": [
          "Catalog"
        ],
        "summary": "List All Category Groups",
        "description": "This endpoint returns a paged list of all the groups associated with the specified\r\ncategory.",
        "operationId": "Catalog_GetCategoryGroups",
        "parameters": [
          {
            "name": "categoryId",
            "in": "path",
            "description": "The Id of the category whose groups should be returned.",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Used for paging. The number of groups to skip. Default is 0.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Used for paging. The maximum number of groups to return. Default is 10.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Category found and groups returned.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgApiModel.Common.PagedApiResult_TcgApiModel.Catalog.Group_"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgApiModel.Common.PagedApiResult_TcgApiModel.Catalog.Group_"
                }
              }
            }
          },
          "400": {
            "description": "CategoryId is less than or equal to 0."
          },
          "404": {
            "description": "Category could not be found or no groups found."
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.tcgplayer.com"
    }
  ],
  "components": {
    "schemas": {
      "TcgApiModel.Catalog.Group": {
        "type": "object",
        "properties": {
          "groupId": {
            "format": "int32",
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "abbreviation": {
            "type": "string"
          },
          "isSupplemental": {
            "type": "boolean"
          },
          "publishedOn": {
            "format": "date-time",
            "type": "string"
          },
          "modifiedOn": {
            "format": "date-time",
            "type": "string"
          },
          "categoryId": {
            "format": "int32",
            "type": "integer"
          }
        }
      },
      "TcgApiModel.Common.PagedApiResult_TcgApiModel.Catalog.Group_": {
        "type": "object",
        "properties": {
          "totalItems": {
            "format": "int32",
            "type": "integer"
          },
          "success": {
            "type": "boolean"
          },
          "errors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TcgApiModel.Catalog.Group"
            }
          }
        }
      }
    }
  },
  "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
    }
  }
}
```