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

This listing comes from the current Store's inventory whose Seller is associated with the user's bearer token making this API call.

Returns a list of all of the groups that are currently for sale by the authenticated store. This can be useful for generating a cascading inventory page.

[block:code]
{
  "codes": [
    {
      "code": "{\n    \"totalItems\": 193,\n    \"success\": true,\n    \"errors\": [],\n    \"results\": [\n        {\n            \"groupId\": 2098,\n            \"name\": \"Rivals of Ixalan\",\n            \"abbreviation\": \"RIX\",\n            \"supplemental\": false,\n            \"publishedOn\": \"1/19/2018\",\n            \"category\": {\n                \"categoryId\": 1,\n                \"name\": \"Magic\",\n                \"modifiedOn\": \"2018-03-08T19:05:06.26\",\n                \"displayName\": null,\n                \"seoCategoryName\": null,\n                \"sealedLabel\": null,\n                \"nonSealedLabel\": null,\n                \"conditionGuideUrl\": null,\n                \"isScannable\": false,\n                \"popularity\": 0\n            },\n            \"modifiedOn\": \"0001-01-01T00:00:00\"\n        },\n        {\n            \"groupId\": 2092,\n            \"name\": \"Unstable\",\n            \"abbreviation\": \"UST\",\n            \"supplemental\": true,\n            \"publishedOn\": \"12/8/2017\",\n            \"category\": {\n                \"categoryId\": 1,\n                \"name\": \"Magic\",\n                \"modifiedOn\": \"2018-03-08T19:05:06.26\",\n                \"displayName\": null,\n                \"seoCategoryName\": null,\n                \"sealedLabel\": null,\n                \"nonSealedLabel\": null,\n                \"conditionGuideUrl\": null,\n                \"isScannable\": false,\n                \"popularity\": 0\n            },\n            \"modifiedOn\": \"0001-01-01T00:00:00\"\n        },\n        {\n            \"groupId\": 2077,\n            \"name\": \"Explorers of Ixalan\",\n            \"abbreviation\": \"E02\",\n            \"supplemental\": false,\n            \"publishedOn\": \"11/24/2017\",\n            \"category\": {\n                \"categoryId\": 1,\n                \"name\": \"Magic\",\n                \"modifiedOn\": \"2018-03-08T19:05:06.26\",\n                \"displayName\": null,\n                \"seoCategoryName\": null,\n                \"sealedLabel\": null,\n                \"nonSealedLabel\": null,\n                \"conditionGuideUrl\": null,\n                \"isScannable\": false,\n                \"popularity\": 0\n            },\n            \"modifiedOn\": \"0001-01-01T00:00:00\"\n        },\n        {\n            \"groupId\": 2050,\n            \"name\": \"Iconic Masters\",\n            \"abbreviation\": \"IMA\",\n            \"supplemental\": false,\n            \"publishedOn\": \"11/17/2017\",\n            \"category\": {\n                \"categoryId\": 1,\n                \"name\": \"Magic\",\n                \"modifiedOn\": \"2018-03-08T19:05:06.26\",\n                \"displayName\": null,\n                \"seoCategoryName\": null,\n                \"sealedLabel\": null,\n                \"nonSealedLabel\": null,\n                \"conditionGuideUrl\": null,\n                \"isScannable\": false,\n                \"popularity\": 0\n            },\n            \"modifiedOn\": \"0001-01-01T00:00:00\"\n        },\n        {\n            \"groupId\": 2076,\n            \"name\": \"Duel Decks: Merfolk vs. Goblins\",\n            \"abbreviation\": \"DDT\",\n            \"supplemental\": false,\n            \"publishedOn\": \"11/10/2017\",\n            \"category\": {\n                \"categoryId\": 1,\n                \"name\": \"Magic\",\n                \"modifiedOn\": \"2018-03-08T19:05:06.26\",\n                \"displayName\": null,\n                \"seoCategoryName\": null,\n                \"sealedLabel\": null,\n                \"nonSealedLabel\": null,\n                \"conditionGuideUrl\": null,\n                \"isScannable\": false,\n                \"popularity\": 0\n            },\n            \"modifiedOn\": \"0001-01-01T00:00:00\"\n        },\n        {\n            \"groupId\": 2084,\n            \"name\": \"Gift Boxes and Promos\",\n            \"abbreviation\": \"GBP\",\n            \"supplemental\": false,\n            \"publishedOn\": \"10/20/2017\",\n            \"category\": {\n                \"categoryId\": 1,\n                \"name\": \"Magic\",\n                \"modifiedOn\": \"2018-03-08T19:05:06.26\",\n                \"displayName\": null,\n                \"seoCategoryName\": null,\n                \"sealedLabel\": null,\n                \"nonSealedLabel\": null,\n                \"conditionGuideUrl\": null,\n                \"isScannable\": false,\n                \"popularity\": 0\n            },\n            \"modifiedOn\": \"0001-01-01T00:00:00\"\n        },\n        {\n            \"groupId\": 2043,\n            \"name\": \"Ixalan\",\n            \"abbreviation\": \"XLN\",\n            \"supplemental\": false,\n            \"publishedOn\": \"9/29/2017\",\n            \"category\": {\n                \"categoryId\": 1,\n                \"name\": \"Magic\",\n                \"modifiedOn\": \"2018-03-08T19:05:06.26\",\n                \"displayName\": null,\n                \"seoCategoryName\": null,\n                \"sealedLabel\": null,\n                \"nonSealedLabel\": null,\n                \"conditionGuideUrl\": null,\n                \"isScannable\": false,\n                \"popularity\": 0\n            },\n            \"modifiedOn\": \"0001-01-01T00:00:00\"\n        },\n        {\n            \"groupId\": 2009,\n            \"name\": \"Commander 2017\",\n            \"abbreviation\": \"C17\",\n            \"supplemental\": true,\n            \"publishedOn\": \"8/25/2017\",\n            \"category\": {\n                \"categoryId\": 1,\n                \"name\": \"Magic\",\n                \"modifiedOn\": \"2018-03-08T19:05:06.26\",\n                \"displayName\": null,\n                \"seoCategoryName\": null,\n                \"sealedLabel\": null,\n                \"nonSealedLabel\": null,\n                \"conditionGuideUrl\": null,\n                \"isScannable\": false,\n                \"popularity\": 0\n            },\n            \"modifiedOn\": \"0001-01-01T00:00:00\"\n        },\n        {\n            \"groupId\": 1934,\n            \"name\": \"Hour of Devastation\",\n            \"abbreviation\": \"HOU\",\n            \"supplemental\": false,\n            \"publishedOn\": \"7/14/2017\",\n            \"category\": {\n                \"categoryId\": 1,\n                \"name\": \"Magic\",\n                \"modifiedOn\": \"2018-03-08T19:05:06.26\",\n                \"displayName\": null,\n                \"seoCategoryName\": null,\n                \"sealedLabel\": null,\n                \"nonSealedLabel\": null,\n                \"conditionGuideUrl\": null,\n                \"isScannable\": false,\n                \"popularity\": 0\n            },\n            \"modifiedOn\": \"0001-01-01T00:00:00\"\n        },\n        {\n            \"groupId\": 1904,\n            \"name\": \"Archenemy: Nicol Bolas\",\n            \"abbreviation\": \"AC2\",\n            \"supplemental\": false,\n            \"publishedOn\": \"6/16/2017\",\n            \"category\": {\n                \"categoryId\": 1,\n                \"name\": \"Magic\",\n                \"modifiedOn\": \"2018-03-08T19:05:06.26\",\n                \"displayName\": null,\n                \"seoCategoryName\": null,\n                \"sealedLabel\": null,\n                \"nonSealedLabel\": null,\n                \"conditionGuideUrl\": null,\n                \"isScannable\": false,\n                \"popularity\": 0\n            },\n            \"modifiedOn\": \"0001-01-01T00:00:00\"\n        }\n    ]\n}",
      "language": "json",
      "name": "Example Response #1"
    },
    {
      "code": "{\n    \"totalItems\": integer,\n    \"success\": boolean,\n    \"errors\": [],\n    \"results\": [\n        {\n            \"groupId\": integer,\n            \"name\": \"string\",\n            \"abbreviation\": \"string\",\n            \"supplemental\": boolean,\n            \"publishedOn\": \"string\",\n            \"category\": {\n                \"categoryId\": integer,\n                \"name\": \"string\",\n                \"modifiedOn\": \"datetime\",\n                \"displayName\": string,\n                \"seoCategoryName\": string,\n                \"sealedLabel\": string,\n                \"nonSealedLabel\": string,\n                \"conditionGuideUrl\": string,\n                \"isScannable\": boolean,\n                \"popularity\": integer\n            },\n            \"modifiedOn\": \"datetime\"\n        }\n\t\t]\n}",
      "language": "json",
      "name": "Response Template"
    }
  ]
}
[/block]

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "v1.39.0",
    "title": "TcgApi"
  },
  "paths": {
    "/stores/{storeKey}/inventory/groups": {
      "get": {
        "tags": [
          "Stores"
        ],
        "summary": "List All Groups",
        "description": "This listing comes from the current Store's inventory whose Seller is associated with the user's bearer token making this API call.",
        "operationId": "Stores_GetStoreGroups",
        "parameters": [
          {
            "name": "storeKey",
            "in": "path",
            "description": "Required. A unique key used to identify the caller of the API.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "categoryId",
            "in": "query",
            "description": "If provided, this request will only return groups from the specified category.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "categoryName",
            "in": "query",
            "description": "If provided, this request will only return groups from the specified category",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "channelId",
            "in": "query",
            "description": "The channel to search for results.  Defaults to 0, the TCG Marketplace.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "includeExcludedCategories",
            "in": "query",
            "description": "If true, will return results for excluded categories.  Default is false.",
            "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"
            }
          },
          {
            "name": "inStockOnly",
            "in": "query",
            "description": "If true, will only return Groups which are in-stock.\r\nIf false, will include Groups which have prices but aren't in stock.\r\nIf null, will use Sellers 'Hide Sets without Inventory' Pro Setting.\r\nDefault is null.",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "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
    }
  }
}
```