Skip to main content
GET
/
receipts
List receipts
curl --request GET \
  --url https://integrations.clopos.com/open-api/receipts \
  --header 'x-brand: <api-key>' \
  --header 'x-token: <api-key>' \
  --header 'x-venue: <api-key>'
{
  "success": true,
  "data": [
    {
      "id": 123,
      "venue_id": 123,
      "cash_shift_cid": "<string>",
      "cid": "<string>",
      "user_id": 123,
      "open_by_user_id": 123,
      "close_by_user_id": 123,
      "courier_id": 123,
      "seller_id": 123,
      "terminal_id": 123,
      "source": "<string>",
      "closed_terminal_id": 123,
      "service_notification_id": 123,
      "table_id": 123,
      "hall_id": 123,
      "customer_id": 123,
      "sale_type_id": 123,
      "is_returns": true,
      "guests": 123,
      "status": 123,
      "lock": true,
      "inventory_status": 123,
      "report_status": 123,
      "meta": {
        "preprint_count": 123,
        "sale_type": {
          "name": "<string>"
        },
        "user": {
          "name": "<string>"
        },
        "terminal_updated_at": 123,
        "availiableDeposit": 123,
        "check_close_event": {
          "checked": true,
          "operated_at": "<string>",
          "fails": [
            "<any>"
          ]
        }
      },
      "suspicion": 123,
      "printed": true,
      "total": 123,
      "subtotal": 123,
      "original_subtotal": 123,
      "gift_total": 123,
      "totalCost": 123,
      "payment_methods": [
        {
          "id": 123,
          "name": "<string>",
          "amount": 123
        }
      ],
      "fiscal_id": "<string>",
      "by_cash": 123,
      "by_card": 123,
      "remaining": 123,
      "discount_type": 123,
      "discount_value": 123,
      "discount_rate": 123,
      "rps_discount": 123,
      "service_charge": 123,
      "service_charge_value": 123,
      "i_tax": 123,
      "delivery_fee": 123,
      "e_tax": 123,
      "total_tax": 123,
      "description": "<string>",
      "address": "<string>",
      "terminal_version": "<string>",
      "loyalty_type": "<string>",
      "loyalty_value": 123,
      "order_status": "<string>",
      "order_number": "<string>",
      "created_at": "<string>",
      "updated_at": "<string>",
      "terminal_updated_at": "<string>",
      "closed_at": "<string>",
      "shift_date": "<string>",
      "deleted_at": "<string>",
      "gift_count": 123,
      "total_discount": 123,
      "properties": {
        "daily_id": 123,
        "monthly_id": 123
      },
      "receipt_products": [
        {
          "id": 123,
          "cid": "<string>",
          "product_id": 123,
          "receipt_id": 123,
          "product_hash": "<string>",
          "meta": {},
          "count": 123,
          "portion_size": 123,
          "total": 123,
          "price": 123,
          "cost": 123,
          "is_gift": true,
          "preprint_count": 123,
          "station_printed_count": 123,
          "station_aborted_count": 123,
          "seller_id": 123,
          "loyalty_type": "<string>",
          "loyalty_value": 123,
          "discount_rate": 123,
          "discount_value": 123,
          "discount_type": 123,
          "total_discount": 123,
          "subtotal": 123,
          "receipt_discount": 123,
          "created_at": "<string>",
          "updated_at": "<string>",
          "terminal_updated_at": "<string>",
          "deleted_at": "<string>",
          "receipt_product_modificators": [
            "<any>"
          ],
          "taxes": [
            "<any>"
          ]
        }
      ],
      "stock_operations": [
        "<any>"
      ],
      "customer": {}
    }
  ],
  "total": 123,
  "time": 123,
  "timestamp": "<string>",
  "unix": 123
}

Purpose

Speeds up your reconciliation flows by listing sales receipts by date, amount, or status.

HTTP Request

GET https://integrations.clopos.com/open-api/receipts

Authorization

The following headers are mandatory:
  • x-token
  • x-brand
  • x-venue

Request Example

curl --location --globoff "https://integrations.clopos.com/open-api/receipts?page=1&sort[0]=created_at&sort[1]=-1&limit=50&date[0]=2025-08-12&date[1]=2025-08-18" \
  -H "x-token: oauth_example_token" \
  -H "x-brand: openapitest" \
  -H "x-venue: 1"

Response

200 OK — List of receipts

{
  "success": true,
  "data": [
    {
      "id": 1,
      "venue_id": 1,
      "cid": "43025959-0e82-4fbd-bcc7-1bc0101183b7",
      "user_id": 1,
      "terminal_id": 1,
      "source": "web",
      "sale_type_id": 1000,
      "guests": 1,
      "status": 2,
      "lock": false,
      "inventory_status": 0,
      "report_status": 3,
      "meta": {
        "preprint_count": 0,
        "sale_type": {
          "name": "Satis usulu 1"
        },
        "user": {
          "name": "Clopos"
        },
        "terminal_updated_at": 1755524813947,
        "availiableDeposit": 30000,
        "check_close_event": {
          "checked": true,
          "operated_at": "2025-08-19 16:01:16",
          "fails": []
        }
      },
      "printed": false,
      "total": 30000,
      "subtotal": 30000,
      "original_subtotal": 30000,
      "gift_total": 0,
      "payment_methods": [
        {
          "id": 1,
          "name": "Cash",
          "amount": 30000
        }
      ],
      "by_cash": 30000,
      "by_card": 0,
      "remaining": 0,
      "discount_type": 0,
      "discount_value": 0,
      "discount_rate": 0,
      "service_charge": 0,
      "service_charge_value": 0,
      "delivery_fee": 0,
      "total_tax": 0,
      "created_at": "2025-08-18 13:45:16",
      "updated_at": "2025-08-19 16:54:15",
      "closed_at": "2025-08-18 14:47:05",
      "shift_date": "2025-08-18",
      "deleted_at": null,
      "properties": {
        "daily_id": 1,
        "monthly_id": 1
      }
    }
  ],
  "total": 1,
  "time": 142,
  "timestamp": "2025-10-06 09:19:49",
  "unix": 1759742389,
  "sorts": [
    "id",
    "cid",
    "user_id",
    "terminal_id",
    "table_id",
    "hall_id",
    "customer_id",
    "status",
    "guests",
    "total",
    "subtotal",
    "totalCost",
    "gift_total",
    "remaining",
    "suspicion",
    "discount_type",
    "discount_value",
    "discount_rate",
    "service_charge",
    "created_at",
    "updated_at",
    "closed_at",
    "deleted_at",
    "products.status",
    "products.type",
    "delivery_fee",
    "loyalty_value",
    "total_tax"
  ]
}

400 Bad Request — Parameter error

{
  "success": false,
  "error": "invalid_parameter",
  "message": "sort[1] must be 1 or -1"
}

401 Unauthorized — Missing header

{
  "success": false,
  "error": "unauthorized",
  "message": "Missing authentication headers"
}

Field Reference

Top-level fields

FieldTypeDescription
successbooleanIndicates the result of the request.
dataarrayList of receipt objects.
totalnumberTotal number of receipts matching filters.
timenumberResponse time in milliseconds.
timestampstringServer timestamp (YYYY-MM-DD HH:mm:ss).
unixnumberUnix timestamp in seconds.
sortsarrayAvailable sort fields.

Receipt object (selected fields)

FieldTypeDescription
idnumberUnique receipt identifier.
cidstringTransaction UUID.
statusnumberReceipt status code.
sale_type_idnumberSale type identifier.
totalnumberTotal amount collected.
subtotalnumberSubtotal before adjustments.
by_cashnumberAmount paid in cash.
by_cardnumberAmount paid by card.
payment_methodsarrayDetailed payment method breakdown.
metaobjectAdditional metadata such as sale type and user.
created_atstringReceipt creation time (YYYY-MM-DD HH:mm:ss).
closed_atstringReceipt close time (YYYY-MM-DD HH:mm:ss).
shift_datestringShift date associated with the receipt.
propertiesobjectOther derived identifiers (e.g., daily_id).

payment_methods[]

FieldTypeDescription
idnumberPayment method ID.
namestringPayment method name.
amountnumberAmount paid using this method.

Notes

  • Use the date[0] and date[1] filters to restrict receipts to a date range (inclusive, YYYY-MM-DD).
  • Sorting accepts multiple fields (sort[0], sort[1], etc.); directions must be 1 (ascending) or -1 (descending).
  • Pagination uses classic page and limit semantics; the default limit is 50.
  • Combine status, sale_type_id, and terminal_id filters via the OpenAPI explorer when you need more granular reporting.
  • Inspect sorts in the response to discover additional sortable fields supported by the API.
  • Directly created receipts do not trigger POS notifications or external updates; they are saved closed for reconciliation.

Authorizations

x-token
string
header
required

Access token obtained from /auth endpoint

x-brand
string
header
required

Brand identifier

x-venue
string
header
required

Venue identifier

Query Parameters

page
integer
default:1

Page number for pagination (starts at 1)

Required range: x >= 1
limit
integer
default:50

Number of receipts to return per page (1-200)

Required range: 1 <= x <= 200
sort[0]
string
default:created_at

Primary sort field

sort[1]
enum<integer>
default:-1

Primary sort direction (1 = ascending, -1 = descending)

Available options:
1,
-1
date[0]
string<date>

Start date (inclusive) in YYYY-MM-DD format

date[1]
string<date>

End date (inclusive) in YYYY-MM-DD format

Response

200 - application/json

Receipts retrieved successfully

success
boolean
data
object[]
total
integer
time
integer
timestamp
string
unix
integer