---
title: "SaleSearchItem"
description: "Summary row for a sale in search results. Use `GET /sales/{sale_id}` for the full `Sale`."
image: "https://developer.sumup.com/og/index.png"
---

> Documentation Index
> Fetch the complete documentation index at: https://developer.sumup.com/llms.txt
> Use this file to discover all available pages before exploring further.

Path: SumUp REST API

Summary row for a sale in search results. Use `GET /sales/{sale_id}` for the full `Sale`.

## Fields

- `id` (`SaleSearchItem.id`; string, required) — Sale identifier.
  - example `"dbe3178d-4b83-5024-9b26-9b8e1b280514"`
- `state` (`SaleSearchItem.state`; string, required) — Lifecycle state of the sale. Non-finalised sales are never returned; only fully-paid sales.
  - one of `"CLOSED"`; example `"CLOSED"`
- `tax_mode` (`SaleSearchItem.tax_mode`; string, required) — Checkout tax mode for the sale. Same values as `Sale.tax_mode`.
  - one of `"NO_TAX"`, `"GROSS"`, `"NET"`; example `"NO_TAX"`
- `currency` (`SaleSearchItem.currency`; object, required) — The currency of the sale.
  - `code` (`SaleSearchItem.currency.code`; string, required) — 3-letter currency code as defined by ISO-4217.
    - format `iso-4217`; minLength 3; maxLength 3; example `"EUR"`
  - `scale` (`SaleSearchItem.currency.scale`; integer, required) — The scaling factor to apply to the value to arrive at the currency's major unit. Providing a scale mitigates changes to the minor unit over time, for example due to inflation. For example, if `scale` is denoted by `s` and `value` is denoted by `v` is the value, then one arrives at the major currency value by calculating `v / 10^s`.
    - example `2`
- `total_amount` (`SaleSearchItem.total_amount`; integer, required) — Final sale gross total after discounts and taxes, excluding tips. Same value as `Sale.price.gross_amount`, in minor units according to `currency.scale`. Payment amounts include tips and can therefore differ from this total.
  - format `int64`; example `1250`
- `created_at` (`SaleSearchItem.created_at`; string, required) — Instant when the sale was created.
  - format `date-time`; example `"2026-06-01T14:30:00Z"`
- `closed_at` (`SaleSearchItem.closed_at`; string, required) — Instant when the sale was closed. Always present: non-finalised sales are never returned.
  - format `date-time`; example `"2026-06-01T14:35:00Z"`
- `user_id` (`SaleSearchItem.user_id`; string, optional) — Identity UUID of the cashier who processed the sale. Omitted when the cashier identity is unknown.
  - format `uuid`; example `"d6f51684-519b-454c-bdb3-deeb05f52b92"`
- `name` (`SaleSearchItem.name`; string, optional) — Display name of the sale when set; otherwise a concatenation of item names with quantities. Omitted when neither is available.
  - example `"Order 1234"`


Source: https://developer.sumup.com/api/schemas/SaleSearchItem/index.md
