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 Groups Details

This endpoint returns all groups that match the specified criteria.

Many products refer to groups by an alternative name such as "Sets." This endpoint will return more detailed information about a specific group of products, which can be useful for separating products into individual groups. Groups for all products in the TCGplayer catalog are included.

[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      \"supplemental\": true,\n      \"publishedOn\": \"string\",\n      \"modifiedOn\": \"2017-11-21T00:47:27.195Z\"\n      \"categoryId\": 0\n    }\n  ]\n}",
      "language": "json",
      "name": "Response Template"
    },
    {
      "code": "/catalog/groups?offset=4&limit=2&categoryId=3\n\nHeaders:\nAuthorization | {{bearerToken}}\n\n{\n    \"totalItems\": 141,\n    \"success\": true,\n    \"errors\": [],\n    \"results\": [\n        {\n            \"groupId\": 1663,\n            \"name\": \"Base Set (Shadowless)\",\n            \"abbreviation\": \"BS\",\n            \"isSupplemental\": false,\n            \"publishedOn\": \"2019-03-05T16:05:47.9727348Z\",\n            \"modifiedOn\": \"2019-02-05T15:09:16.78\",\n            \"categoryId\": 3\n        },\n        {\n            \"groupId\": 605,\n            \"name\": \"Base Set 2\",\n            \"abbreviation\": \"B2\",\n            \"isSupplemental\": false,\n            \"publishedOn\": \"2019-03-05T16:05:47.9883626Z\",\n            \"modifiedOn\": \"2018-10-03T13:13:45.307\",\n            \"categoryId\": 3\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/groups": {
      "get": {
        "tags": [
          "Catalog"
        ],
        "summary": "List All Groups Details",
        "description": "This endpoint returns all groups that match the specified criteria.",
        "operationId": "Catalog_GetGroups",
        "parameters": [
          {
            "name": "categoryId",
            "in": "query",
            "description": "If specified, only return groups from this category.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "categoryName",
            "in": "query",
            "description": "If specified, only return groups from categories with this exact name.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "isSupplemental",
            "in": "query",
            "description": "If true, only return supplemental groups.  If false, return only non-supplemental\r\ngroups. Otherwise, return all groups regardless of whether they are supplemental or\r\nnot.",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "hasSealed",
            "in": "query",
            "description": "If true, only return groups that contain sealed product.  If false, only return\r\ngroups that do not contain sealed product.  Otherwise, return all groups regardless\r\nof whether they have sealed product or not.",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "sortOrder",
            "in": "query",
            "description": "The name of the property to sort the returned groups by. Default is GroupName.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sortDesc",
            "in": "query",
            "description": "If true then sort descending, otherwise sort ascending.",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "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": "Groups found and 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_"
                }
              }
            }
          }
        }
      }
    }
  },
  "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
    }
  }
}
```