Parrot External API
  1. Discounts
Parrot External API
  • Home
  • Changelog
  • Authentication and Usage
  • Endpoints
    • Inventory Management
      • List Suppliers
      • List Supplies
      • List Supply Events
    • Orders
      • List Orders
      • V1 - List Order Items
      • V2 - List Order Items
      • List Product Types
    • Discounts
      • List Discounts
        GET
      • List Discount Usages
        GET
    • List All Stores
      GET
    • List Order Invoices
      GET
    • List Order Payments
      GET
    • List Cashier Sessions
      GET
    • List Store Users
      GET
  1. Discounts

List Discount Usages

GET
/v1/discount-usages
This endpoint retrieves discount usages by a given time range
Note: startTimestamp and endTimestamp must be at most 48 hours apart.

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET '/v1/discount-usages?startTimestamp=2024-03-27T19:00:00-06:00&endTimestamp=2024-03-28T19:00:00-06:00&pageSize=100&page=0&storeUUID=a2f09385-7f1b-436c-9baa-bb9cf1174c25&storeUUID=206b8416-c3c8-4053-9bdf-a11f3ddd7da1' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK
application/json
Body

Example
{
    "pagination": {
        "next": null,
        "previous": null,
        "count": 1,
        "current": 0,
        "pageSize": 100
    },
    "data": [
        {
            "createdAt": "2025-02-04T04:41:49Z",
            "provider": "PARROT",
            "uuid": "a6bc4d81-9e41-4daf-8cf9-650ba981a79d",
            "orderReference": "030225-P-0044",
            "appliedTo": "b13bf589-39a4-4c9d-9d44-d5d840966c31",
            "appliedType": "ORDER",
            "appliedByUserUuid": "69861696-af13-4686-b9e1-7e6f66080160",
            "amount": 39.60,
            "discountUuid": "7f9aef2c-a917-4517-98a5-3b78d93b32f2",
            "discountName": "Descuento Staff",
            "discountType": "OPEN",
            "discountScope": "ORDER"
        },
        {
            "createdAt": "2025-02-04T04:43:03Z",
            "provider": "PARROT",
            "uuid": "4f3ebe48-8635-4911-96e4-844a788eb40a",
            "orderReference": "030225-P-0037",
            "appliedTo": "f61ae9d4-5e02-4133-9a3d-6e9511ce9527",
            "appliedType": "ORDER",
            "appliedByUserUuid": "69861696-af13-4686-b9e1-7e6f66080160",
            "amount": 39.60,
            "discountUuid": "7f9aef2c-a917-4517-98a5-3b78d93b32f2",
            "discountName": "Descuento Staff",
            "discountType": "OPEN",
            "discountScope": "ORDER"
        },
        {
            "createdAt": "2025-02-04T04:43:58Z",
            "provider": "PARROT",
            "uuid": "012236d5-e9c0-496f-9dfa-4a7aeeae70e0",
            "orderReference": "030225-P-0066",
            "appliedTo": "97d6216c-c853-49c9-abd9-3331f0f8053d",
            "appliedType": "ORDER",
            "appliedByUserUuid": "69861696-af13-4686-b9e1-7e6f66080160",
            "amount": 98.00,
            "discountUuid": "7f9aef2c-a917-4517-98a5-3b78d93b32f2",
            "discountName": "Descuento Staff",
            "discountType": "OPEN",
            "discountScope": "ORDER"
        },
        {
            "createdAt": "2025-02-04T23:45:21Z",
            "provider": "PARROT",
            "uuid": "4ec5498e-efba-4f83-9ac9-be75e42defa1",
            "orderReference": "040225-P-0004",
            "appliedTo": "38acca11-0b5d-4b41-bfdb-154e168eafd6",
            "appliedType": "ORDER",
            "appliedByUserUuid": "646ed268-3a58-4d44-b90b-4fbce456e533",
            "amount": 631.00,
            "discountUuid": "f5b3a493-9049-4a4a-9997-c65d1045eb4a",
            "discountName": "CARD_REWARD_DISCOUNT",
            "discountType": "OPEN",
            "discountScope": "ORDER"
        },
        {
            "createdAt": "2025-02-04T23:46:05Z",
            "provider": "PARROT",
            "uuid": "edf6c819-18cb-4fcd-a672-a85e4801e8c9",
            "orderReference": "040225-P-0007",
            "appliedTo": "ff32f46f-0b85-4980-b8ef-88fbf39570e8",
            "appliedType": "ORDER",
            "appliedByUserUuid": "646ed268-3a58-4d44-b90b-4fbce456e533",
            "amount": 555.00,
            "discountUuid": "f5b3a493-9049-4a4a-9997-c65d1045eb4a",
            "discountName": "CARD_REWARD_DISCOUNT",
            "discountType": "OPEN",
            "discountScope": "ORDER"
        }
    ],
    "datetime": "2026-02-16T12:24:11-06:00"
}
Modified at 2026-02-16 18:24:40
Previous
List Discounts
Next
List All Stores
Built with