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 Products

This endpoint returns all products that match the specified criteria.

One option for a product search, List All Products returns detailed information about a product based on query strings. It is a great endpoint when you want to perform a search and then take action on the data returned, such as displaying images or returning productConditionId for more detailed pricing searches.

[block:code]
{
  "codes": [
    {
      "code": "{\n  \"totalItems\": 0,\n  \"success\": true,\n  \"errors\": [\n    \"string\"\n  ],\n  \"results\": [\n    {\n      \"productId\": 0,\n      \"name\": \"string\",\n      \"cleanName\": \"string\",\n      \"imageUrl\": \"string\",\n      \"categoryId\": 0,\n      \"groupId\": 0,\n      \"url\": \"string\",\n      \"modifiedOn\": \"2017-11-21T00:47:27.254Z\",\n    }\n  ]\n}",
      "language": "json",
      "name": "Response Template"
    },
    {
      "code": "/catalog/products?categoryId=8&productTypes=Cards&limit=2\n\n{\n    \"totalItems\": 31,\n    \"success\": true,\n    \"errors\": [],\n    \"results\": [\n        {\n            \"productId\": 99378,\n            \"name\": \"Justice ID Card\",\n            \"cleanName\": \"Justice ID Card\",\n            \"imageUrl\": \"https://6d4be195623157e28848-7697ece4918e0a73861de0eb37d08968.ssl.cf1.rackcdn.com/99378_200w.jpg\",\n            \"categoryId\": 8,\n            \"groupId\": 1557,\n            \"url\": \"https://store.tcgplayer.com/heroclix/avengers-assemble/justice-id-card\",\n            \"modifiedOn\": \"2015-09-02T19:06:17.317\"\n        },\n        {\n            \"productId\": 100192,\n            \"name\": \"Black Widow ID Card\",\n            \"cleanName\": \"Black Widow ID Card\",\n            \"imageUrl\": \"https://6d4be195623157e28848-7697ece4918e0a73861de0eb37d08968.ssl.cf1.rackcdn.com/100192_200w.jpg\",\n            \"categoryId\": 8,\n            \"groupId\": 1557,\n            \"url\": \"https://store.tcgplayer.com/heroclix/avengers-assemble/black-widow-id-card\",\n            \"modifiedOn\": \"2015-09-02T18:59:14.34\"\n        }\n    ]\n}",
      "language": "json",
      "name": "Example Response #1"
    },
    {
      "code": "/catalog/products?categoryId=1&productTypes=Cards&limit=2\n\n{\n    \"totalItems\": 41712,\n    \"success\": true,\n    \"errors\": [],\n    \"results\": [\n        {\n            \"productId\": 86,\n            \"name\": \"Abyssal Nightstalker\",\n            \"cleanName\": \"Abyssal Nightstalker\",\n            \"imageUrl\": \"https://6d4be195623157e28848-7697ece4918e0a73861de0eb37d08968.ssl.cf1.rackcdn.com/86_200w.jpg\",\n            \"categoryId\": 1,\n            \"groupId\": 87,\n            \"url\": \"https://store.tcgplayer.com/magic/portal-second-age/abyssal-nightstalker\",\n            \"modifiedOn\": \"2013-05-09T12:13:41.653\"\n        },\n        {\n            \"productId\": 87,\n            \"name\": \"Air Elemental\",\n            \"cleanName\": \"Air Elemental\",\n            \"imageUrl\": \"https://6d4be195623157e28848-7697ece4918e0a73861de0eb37d08968.ssl.cf1.rackcdn.com/87_200w.jpg\",\n            \"categoryId\": 1,\n            \"groupId\": 87,\n            \"url\": \"https://store.tcgplayer.com/magic/portal-second-age/air-elemental\",\n            \"modifiedOn\": \"2013-05-09T12:13:41.653\"\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/products": {
      "get": {
        "tags": [
          "Catalog"
        ],
        "summary": "List All Products",
        "description": "This endpoint returns all products that match the specified criteria.",
        "operationId": "Catalog_GetProducts",
        "parameters": [
          {
            "name": "categoryId",
            "in": "query",
            "description": "If specified, only return products in this category.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "categoryName",
            "in": "query",
            "description": "If specified, only return products in this category.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "groupId",
            "in": "query",
            "description": "If specified, only return products in this group.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "groupName",
            "in": "query",
            "description": "If specified, only return products in this group.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "productName",
            "in": "query",
            "description": "If specified, only return products with this exact name.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "getExtendedFields",
            "in": "query",
            "description": "If true, include additional category-specific information about each product, otherwise\r\nonly return general product. Default is false.",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "productTypes",
            "in": "query",
            "description": "A comma-separated list of Product Types. If specified, only return Products that\r\nbelong to one of the Product Types in the list. Some valid values: Cards, Booster Pack,\r\nBooster Box.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Used for paging. The number of Products to skip. Default is 0.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Used for paging. The maximum number of Products to return. Default is 10.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "includeSkus",
            "in": "query",
            "description": "If true, include SKU details for each product.  Default is false.",
            "required": false,
            "schema": {
              "type": "boolean"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Products found and returned.",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgApiModel.Common.PagedApiResult_TcgApiModel.Catalog.CatalogProduct_"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgApiModel.Common.PagedApiResult_TcgApiModel.Catalog.CatalogProduct_"
                }
              }
            }
          },
          "404": {
            "description": "No products found."
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.tcgplayer.com"
    }
  ],
  "components": {
    "schemas": {
      "TcgApiModel.Catalog.CatalogProduct": {
        "type": "object",
        "properties": {
          "productId": {
            "format": "int64",
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "cleanName": {
            "type": "string"
          },
          "imageUrl": {
            "type": "string"
          },
          "categoryId": {
            "format": "int32",
            "type": "integer"
          },
          "groupId": {
            "format": "int32",
            "type": "integer"
          },
          "url": {
            "type": "string"
          },
          "modifiedOn": {
            "format": "date-time",
            "type": "string"
          },
          "skus": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TcgApiModel.Catalog.Sku"
            }
          },
          "imageCount": {
            "format": "int32",
            "type": "integer"
          },
          "presaleInfo": {
            "$ref": "#/components/schemas/TcgApiModel.Catalog.PresaleInfo"
          },
          "extendedData": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TcgApiModel.Catalog.ExtendedDataInfo"
            }
          }
        }
      },
      "TcgApiModel.Catalog.Sku": {
        "type": "object",
        "properties": {
          "skuId": {
            "format": "int64",
            "type": "integer"
          },
          "productId": {
            "format": "int64",
            "type": "integer"
          },
          "languageId": {
            "format": "int32",
            "type": "integer"
          },
          "printingId": {
            "format": "int32",
            "type": "integer"
          },
          "conditionId": {
            "format": "int32",
            "type": "integer"
          }
        }
      },
      "TcgApiModel.Catalog.PresaleInfo": {
        "type": "object",
        "properties": {
          "isPresale": {
            "type": "boolean"
          },
          "releasedOn": {
            "format": "date-time",
            "type": "string"
          },
          "note": {
            "type": "string"
          }
        }
      },
      "TcgApiModel.Catalog.ExtendedDataInfo": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "displayName": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "TcgApiModel.Common.PagedApiResult_TcgApiModel.Catalog.CatalogProduct_": {
        "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.CatalogProduct"
            }
          }
        }
      }
    }
  },
  "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
    }
  }
}
```