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

# Get ProductList By Key

Returns the ProductList specified by using the ProductListKey.

Similar to Get ProductList By Id, this endpoint pulls data about a product list. The response format matches the response format for Get ProductList By Id.

[block:code]
{
  "codes": [
    {
      "code": "{\n    \"success\": boolean,\n    \"errors\": [],\n    \"results\": [\n        {\n            \"productListItems\": [\n                {\n                    \"productListItemId\": integer,\n                    \"quantity\": integer,\n                    \"productCondition\": {\n                        \"productConditionId\": integer,\n                        \"name\": \"string\",\n                        \"language\": \"string\",\n                        \"isFoil\": boolean\n                    }\n                },\n                {\n                    \"productListItemId\": integer,\n                    \"quantity\": integer,\n                    \"productCondition\": {\n                        \"productConditionId\": integer,\n                        \"name\": \"string\",\n                        \"language\": \"string\",\n                        \"isFoil\": boolean\n                    }\n                }\n            ],\n            \"productListId\": integer,\n            \"productListKey\": \"string\",\n            \"createdAt\": \"datetime\"\n        }\n    ]\n}",
      "language": "json",
      "name": "Response Template"
    },
    {
      "code": "{\n    \"success\": true,\n    \"errors\": [],\n    \"results\": [\n        {\n            \"productListItems\": [\n                {\n                    \"productListItemId\": 3103043,\n                    \"quantity\": 3,\n                    \"productCondition\": {\n                        \"productConditionId\": 3799,\n                        \"name\": \"Near Mint\",\n                        \"language\": \"English\",\n                        \"isFoil\": false\n                    }\n                },\n                {\n                    \"productListItemId\": 3103044,\n                    \"quantity\": 2,\n                    \"productCondition\": {\n                        \"productConditionId\": 21163,\n                        \"name\": \"Near Mint\",\n                        \"language\": \"English\",\n                        \"isFoil\": false\n                    }\n                }\n            ],\n            \"productListId\": 166732,\n            \"productListKey\": \"aab5f8d0-1266-46ec-87f0-daa45f3373a8\",\n            \"createdAt\": \"2018-02-09T13:33:50.557\"\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": {
    "/inventory/productlists/{productListKey}": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "Get ProductList By Key",
        "description": "Returns the ProductList specified by using the ProductListKey.",
        "operationId": "Inventory_GetProductListByKey",
        "parameters": [
          {
            "name": "productListKey",
            "in": "path",
            "description": "The Key of the ProductList to be returned.",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgApiModel.Common.ApiResult_TcgApiModel.Inventory.ProductListDetail_"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgApiModel.Common.ApiResult_TcgApiModel.Inventory.ProductListDetail_"
                }
              }
            }
          },
          "404": {
            "description": "Not Found"
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.tcgplayer.com"
    }
  ],
  "components": {
    "schemas": {
      "TcgApiModel.Inventory.ProductListDetail": {
        "type": "object",
        "properties": {
          "productListItems": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TcgApiModel.Inventory.ProductListItem"
            }
          },
          "productListId": {
            "format": "int64",
            "type": "integer"
          },
          "productListKey": {
            "format": "uuid",
            "type": "string"
          },
          "createdOn": {
            "format": "date-time",
            "type": "string"
          }
        }
      },
      "TcgApiModel.Inventory.ProductListItem": {
        "type": "object",
        "properties": {
          "productListItemId": {
            "format": "int64",
            "type": "integer"
          },
          "quantity": {
            "format": "int32",
            "type": "integer"
          },
          "productCondition": {
            "$ref": "#/components/schemas/TcgApiModel.Catalog.ProductCondition"
          }
        }
      },
      "TcgApiModel.Catalog.ProductCondition": {
        "type": "object",
        "properties": {
          "productConditionId": {
            "format": "int64",
            "type": "integer"
          },
          "name": {
            "type": "string"
          },
          "language": {
            "type": "string"
          },
          "isFoil": {
            "type": "boolean"
          }
        }
      },
      "TcgApiModel.Common.ApiResult_TcgApiModel.Inventory.ProductListDetail_": {
        "type": "object",
        "properties": {
          "success": {
            "type": "boolean"
          },
          "errors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/TcgApiModel.Inventory.ProductListDetail"
            }
          }
        }
      }
    }
  },
  "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
    }
  }
}
```