Parrot External API
  1. Discounts
Parrot External API
  • Home
  • Changelog
  • Authentication and Usage
  • Endpoints
    • Inventory Management
      • List Suppliers
      • List Supplies
    • 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 Discounts

Testing
GET
/v1/discounts
This endpoint retrieves discounts for an organization or a list of stores

Request

Authorization
Provide your bearer token in the
Authorization
header when making requests to protected resources.
Example:
Authorization: Bearer ********************
Query Params
pageSize
integer 
optional
Example:
100
page
string 
optional
Example:
0
storeUUID
array[string]
optional
Example:
["a2f09385-7f1b-436c-9baa-bb9cf1174c25","206b8416-c3c8-4053-9bdf-a11f3ddd7da1"]

Request 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/discounts?pageSize=100&page=0&storeUUID=a2f09385-7f1b-436c-9baa-bb9cf1174c25&storeUUID=206b8416-c3c8-4053-9bdf-a11f3ddd7da1'

Responses

🟢200OK
application/json
Body
pagination
object 
required
next
integer 
required
previous
integer 
required
count
integer 
required
current
integer 
required
pageSize
integer 
required
data
array [object {11}] 
required
uuid
string 
required
createdAt
string 
required
deletedAt
string  | null 
required
storeUuid
string 
required
name
string 
required
discountType
string 
required
FIXED or OPEN. A discount is open if the user can input what amount or % should be applied.
discountAmount
integer 
required
amountType
string 
required
PERCENTAGE or PRICED
isRestricted
boolean 
required
True if it requires special permissions to grant the discount.
discountScope
string 
required
ORDER or ORDER_ITEM
isEnabled
boolean 
required
datetime
string 
required
Example
{
    "pagination": {
        "next": null,
        "previous": null,
        "count": 1,
        "current": 0,
        "pageSize": 100
    },
    "data": [
        {
            "uuid": "a94a2adf-1c8e-4c4e-a705-7d62f263b8b4",
            "createdAt": "2025-06-24T01:33:50.900Z",
            "deletedAt": null,
            "storeUuid": "b5e10676-3ec6-4d0c-8853-bca1d4896590",
            "name": "quenut electrolit",
            "discountType": "FIXED",
            "discountAmount": 7.0,
            "amountType": "PERCENTAGE",
            "isRestricted": false,
            "discountScope": "ORDER_ITEM",
            "isEnabled": true
        },
        {
            "uuid": "2e4f0300-49f7-42df-bdde-2f02aa55959d",
            "createdAt": "2025-06-24T01:10:16.390Z",
            "deletedAt": "2025-06-24T01:33:04.965Z",
            "storeUuid": "b5e10676-3ec6-4d0c-8853-bca1d4896590",
            "name": "electrolit quenut",
            "discountType": "FIXED",
            "discountAmount": 7.0,
            "amountType": "PERCENTAGE",
            "isRestricted": false,
            "discountScope": "ORDER_ITEM",
            "isEnabled": true
        },
        {
            "uuid": "b935a402-704d-4da5-a5a9-d7c31bf15e08",
            "createdAt": "2022-02-25T19:18:19.156Z",
            "deletedAt": "2023-04-25T21:16:20.957Z",
            "storeUuid": "d266d6db-46b9-4c8e-85c0-875246a3db72",
            "name": "Loyalty Card 20%",
            "discountType": "FIXED",
            "discountAmount": 20.0,
            "amountType": "PERCENTAGE",
            "isRestricted": false,
            "discountScope": "ORDER",
            "isEnabled": true
        }
    ],
    "datetime": "2025-07-01T15:03:13-06:00"
}
Modified at 2025-07-01 21:15:12
Previous
List Product Types
Next
List Discount Usages
Built with