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

# Search Orders

Search Orders.

Returns an array containing the order numbers that match a specific search criteria.

[block:code]
{
  "codes": [
    {
      "code": "{\n    \"totalItems\": integer,\n    \"success\": boolean,\n    \"errors\": [],\n    \"results\": [\n        \"string\"\n    ]\n}",
      "language": "json",
      "name": "Response Template"
    },
    {
      "code": "{\n    \"totalItems\": 1,\n    \"success\": true,\n    \"errors\": [],\n    \"results\": [\n        \"23132-0A4D52-A147D\"\n    ]\n}",
      "language": "json",
      "name": "Example Response #1"
    }
  ]
}
[/block]

# OpenAPI definition

```json
{
  "openapi": "3.0.0",
  "info": {
    "version": "v1.39.0",
    "title": "TcgApi"
  },
  "paths": {
    "/stores/{storeKey}/orders": {
      "get": {
        "tags": [
          "Stores"
        ],
        "summary": "Search Orders",
        "description": "Search Orders.",
        "operationId": "Stores_GetStoreOrders",
        "parameters": [
          {
            "name": "storeKey",
            "in": "path",
            "description": "Required. A unique key used to identify the caller of the API.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "orderNumber",
            "in": "query",
            "description": "If provided, only return the order for the order number specified.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "customerName",
            "in": "query",
            "description": "If provided, only return orders where the buyer's name contains the specified string. Format \"Firstname, Lastname\".",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "customerEmail",
            "in": "query",
            "description": "If provided, only return orders where the buyer's email address contains the specified string.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "minOrderValue",
            "in": "query",
            "description": "If provided, only return orders with ProductAmt >= the specified value.",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "maxOrderValue",
            "in": "query",
            "description": "If provided, only return orders with ProductAmt <= the specified value.",
            "required": false,
            "schema": {
              "type": "number",
              "format": "double"
            }
          },
          {
            "name": "channelIds",
            "in": "query",
            "description": "A comma delimited list of order channel Ids. If provided, only return orders from the specified channels.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "orderStatusIds",
            "in": "query",
            "description": "A comma delimited list of order status Ids. If provided, only return orders in the specified order statuses.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "pickupStatusIds",
            "in": "query",
            "description": "A comma delimited list of pickup status Ids. If provided, only return orders in the specified pickup statuses.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "deliveryTypeIds",
            "in": "query",
            "description": "A comma delimited list of deliveryTypeIds. If provided, only return orders in the specified delivery types.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "presaleStatusIds",
            "in": "query",
            "description": "A comma delimited list of presale status Ids. If provided, only return orders in the specified presale statuses.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "orderTypeIds",
            "in": "query",
            "description": "A comma delimited list of order type Ids. If provided, only return orders in the specified order types.",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "sort",
            "in": "query",
            "description": "Used for sorting. Default is \"OrderStatus Asc\".  Acceptable sort terms are: OrderNumber, OrderDate, OrderStatus, ShippingName, ProductAmt, ShippingAmt, SellerTaxAmt, OrderAmt",
            "required": false,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "offset",
            "in": "query",
            "description": "Used for paging. The number of order numbers to skip. Default is 0.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "description": "Used for paging. The maximum number of order numbers to return. Default is 10.",
            "required": false,
            "schema": {
              "type": "integer",
              "format": "int32"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgApiModel.Common.PagedApiResult_System.String_"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/TcgApiModel.Common.PagedApiResult_System.String_"
                }
              }
            }
          }
        }
      }
    }
  },
  "servers": [
    {
      "url": "https://api.tcgplayer.com"
    }
  ],
  "components": {
    "schemas": {
      "TcgApiModel.Common.PagedApiResult_System.String_": {
        "type": "object",
        "properties": {
          "totalItems": {
            "format": "int32",
            "type": "integer"
          },
          "success": {
            "type": "boolean"
          },
          "errors": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "results": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      }
    }
  },
  "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
    }
  }
}
```