List Payments
GET /payments
You can use this endpoint to retrieve a list of payments, newest first. Optionally, you can use the filter parameter to pick a period, a payment method, one order, one gift card or one till.
Use the Pagination and Querying sections to learn more about how to complete this request.
Available Fields to Query
| Field Name | Type | Description |
|---|---|---|
DATE | date | When the order was completed. On refund payments: when the refund was made |
PAYMENT_METHOD | text | CREDIT_CARD, MOBILE_PAY, DIRECT_VIPPS_MOBILEPAY, CASH, GIFTCARD, GIFTUP, CUSTOM or INTERNAL |
ORDER_ID | uuid | The order |
REFUND_ID | uuid | The refund. IS_EMPTY keeps the payments taken only, NOT_IS_EMPTY the refund payments only |
GIFTCARD_ID | uuid | The gift card spent |
CASH_REGISTER_ID | uuid | The till |
DATE values are milliseconds since 1 January 1970 UTC. IS_EMPTY and NOT_IS_EMPTY take no value. INCLUDES takes a list, for example several payment methods at once.
Example: Card payments on one day
Card payments on 14 November 2026, Copenhagen time. The sum of amount is what was taken by card that day, and the sum of fee what the payment provider charged for it.
{ "operator": "AND", "conditions": [ { "operator": "EQUAL", "fieldName": "PAYMENT_METHOD", "value": "CREDIT_CARD" }, { "operator": "GREATER_OR_EQUAL", "fieldName": "DATE", "value": 1794610800000 }, { "operator": "LESSER", "fieldName": "DATE", "value": 1794697200000 } ] }
Example: Where a gift card was spent
{ "operator": "EQUAL", "fieldName": "GIFTCARD_ID", "value": "bd4a0997-39db-41d9-883a-cdfa83e2101f" }
Example: Refunds in a period
{ "operator": "AND", "conditions": [ { "operator": "NOT_IS_EMPTY", "fieldName": "REFUND_ID" }, { "operator": "GREATER_OR_EQUAL", "fieldName": "DATE", "value": 1790805600000 }, { "operator": "LESSER", "fieldName": "DATE", "value": 1793487600000 } ] }
Example Response
{ "total": 2, "list": [ { "id": "3e7a1c0b-2d4f-4e6a-9b8c-5d6e7f8a9b0c", "orderId": "f0a52c7e-9e04-4bb4-bd38-1bb88e1dd0e4", "date": "2026-11-14T10:30:00.000Z", "paymentMethod": "CREDIT_CARD", "wallet": "APPLE_PAY", "cardBrand": "VISA", "amount": 55000, "fee": 770, "giftcardId": null, "customPaymentMethod": null, "refundId": null, "cashRegisterId": null }, { "id": "7c6b5a49-3827-4615-9504-a3b2c1d0e9f8", "orderId": "2b9e4d1a-6c3f-4a7e-8d5b-0f1e2a3b4c5d", "date": "2026-11-14T09:05:00.000Z", "paymentMethod": "CUSTOM", "wallet": null, "cardBrand": null, "amount": 120000, "fee": null, "giftcardId": null, "customPaymentMethod": { "id": "61d0e9f8-a7b6-4c5d-9e4f-3a2b1c0d9e8f", "name": "Faktura" }, "refundId": null, "cashRegisterId": "c1b2a3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d" } ] }