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 Id

Returns the ProductList specified by using the ProductListId.

Product lists can be pulled from the same endpoint through key or id. This endpoint will return more detailed information about a product list. The returned productConditionId fields can be used through product endpoints to return more detailed data about a specific product or through pricing endpoints to return current pricing data.

[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/{productListId}": {
      "get": {
        "tags": [
          "Inventory"
        ],
        "summary": "Get ProductList By Id",
        "description": "Returns the ProductList specified by using the ProductListId.",
        "operationId": "Inventory_GetProductListById",
        "parameters": [
          {
            "name": "productListId",
            "in": "path",
            "description": "The Id of the ProductList to be returned.",
            "required": true,
            "schema": {
              "type": "integer",
              "format": "int64"
            }
          }
        ],
        "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
    }
  }
}
```