---
title: "Search for orders"
method: GET
path: "/stores/{storeId}/orders/search/{query}"
tags: ["Order"]
---

# Search for orders

`GET /stores/{storeId}/orders/search/{query}`

Search orders by ID or customer email in the specified store.
Requires the `stores.orders.view` permission.

## Path parameters

- `storeId` string, uuid, required
- `query` string, required

## Query parameters

- `dateFrom` string, date-time
- `dateTo` string, date-time
- `status` string
- `gateway` string
- `email` string
- `discord` string
- `Filters` string
- `Sorts` string
- `Page` integer
- `PageSize` integer

## Response `200`

The object was successfully returned.

- PageOrderPaginatedResponse — Represents a paginated response returned from API endpoints, which contains the paginated data and metadata about the pagination.
  - `success` boolean, required — Indicates whether the operation was successful
  - `pages` integer, required — The total number of pages available in the paginated response.
  - `data` PageOrder[], required — Represents the collection of items within a paginated response
    - `id` string, uuid, required — The unique identifier of the entity
    - `dateCreated` string, date-time, required — The date the entity was created
    - `items` PublicLineItem[], required — The product that was purchased
      - `id` string, uuid, required — The unique identifier of the entity
      - `dateCreated` string, date-time, required — The date the entity was created
      - `productName` string, required — The name of the product
      - `productId` string, uuid, required — The ID of the product
      - `variantId` string, uuid, required — The ID of the variant they purchased
      - `variantName` string, required — The name of the variant they purchased
      - `amount` number, double, required — The unit cost, how much one unit of the product costs
      - `lineTotal` number, double, required — The total cost for the line item (Amount * Quantity)
      - `additionalFeePercentage` number, double, required — An additional fee percentage applied to the line item, if any.
      - `additionalFeeAmount` number, double, required — The total amount of any additional percentage fees applied to the line item.
      - `additionalFixedFeeAmount` number, double, required — The total amount of any additional fixed fees applied to the line item.
      - `volumeDiscountAmount` number, double, required — The volume discount amount applied to this line item.
      - `volumeDiscountType` 0 | 1 | 2 — Specifies the type of discount to apply for volume pricing tiers.
      - `volumeDiscountValue` number, double, nullable — The discount value from the applied tier (e.g., 10 for 10% or $10).
      - `volumeDiscountTierQuantity` integer, nullable — The quantity threshold of the tier that was applied (e.g., 10 for "Buy 10+").
      - `quantity` integer, required — The amount of product that was purchased
      - `billingInterval` 0 | 1 | 2 | 3 | 4 — The billing interval for a subscription product
      - `customIntervalDays` integer, nullable — Custom interval in days when Komerza.Common.Models.Orders.PublicLineItem.BillingInterval is Komerza.Common.Models.Products.BillingInterval.Custom.
    - `gateway` string, required — The gateway used to facilitate the purchase
    - `customerEmail` string, required — The email address of the customer who created the order
    - `status` string, required — The current payment status
    - `currencyCode` string, required — The fiat currency code used for the order, defaults to USD
    - `amountPaid` number, double, required — The amount that the customer has paid for the invoice
    - `amount` number, double, required — The cost of the order
    - `coupon` PublicOrderCoupon — Represents the usage data of a coupon within an order
      - `id` string, uuid, required — The unique identifier of the entity
      - `dateCreated` string, date-time, required — The date the entity was created
      - `percentageDecrease` number, double, nullable — The percentage the coupon cut off the order, this is null if the coupon was a fixed amount instead which the net decrease is below
      - `netDecrease` number, double, required — The net amount the coupon decreased the order by
      - `code` string, required — The code of the coupon
      - `couponId` string, uuid, required — The ID of the coupon

## Other responses

- `400` — The provided form information is not valid, check that the provided data is valid. You can use the 'invalidFields' field to get the list of invalid fields or just use the 'message' field.
- `401` — You are not authorized, check your API key and try again.
- `403` — You are not authorized to access this endpoint, you may be missing an API key scope or be requesting a privileged endpoint.
- `404` — One of the objects referenced by the ID given in the URL or form was not found, check the ID and try again.

---

[API](https://skmtc.net/komerza/apis/komerza-api.md) · [All operations](https://skmtc.net/komerza/apis/komerza-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/komerza/komerza-api/versions/060e78bc7f80/schema)