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

List Supply Events

Designing
GET
/v1/supply-events
Retrieves inventory supply events like purchases, transfers, and waste (merma)
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/supply-events?startTimestamp=2024-03-27T19:00:00-06:00&endTimestamp=2024-03-28T19:00:00-06:00&pageSize=3&page=1&eventTypes=PURCHASE&eventTypes=PURCHASE_XML&eventTypes=TRANSFER' \
--header 'Authorization: Bearer <token>'

Responses

🟢200OK
application/json
Body

Example
{
    "pagination": {
        "next": null,
        "previous": null,
        "count": 1,
        "current": 0,
        "pageSize": 100
    },
    "data": [
        {
            "eventUuid": "83235534-30dc-45db-a5fd-3c49d4e61428",
            "eventType": "PURCHASE_XML",
            "createdAt": "2026-02-03 00:23:32.854",
            "createdByUserUuid": "0ef8307f-cb40-4813-89ef-4b294be65284",
            "supplyCenterUuid": "048972ed-f075-4996-97d9-d0ce5c483825",
            "supplyCenterName": "Centro de almacenamiento Playa Bichis (Gomez Morin)",
            "purchaseData": null,
            "xmlPurchaseData": {
                "supplierUuid": "7c2c5df1-cecf-426b-8868-2d4f0e0c1dc5",
                "supplierName": "Ramon Lopez Gomez",
                "total": 4806.49,
                "invoiceId": "5FB59926-A8AA-4E32-924F-0B082F7D26F5",
                "invoiceFolioId": "35115",
                "supplies": [
                    {
                        "supplyName": "Avena",
                        "supplyId": "IN-1732229437016",
                        "presentationUnit": "KILOGRAM",
                        "presentationUnitAmount": 1,
                        "amount": 4,
                        "price": 95.2,
                        "unitPrice": 23.8
                    },
                    {
                        "supplyName": "Clamato",
                        "supplyId": "IN-1732229437079",
                        "presentationUnit": "LITER",
                        "presentationUnitAmount": 1.89,
                        "amount": 8,
                        "price": 462.4,
                        "unitPrice": 57.8
                    },
                    {
                        "supplyName": "Catsup mesa",
                        "supplyId": "IN-1732229437048",
                        "presentationUnit": "GRAM",
                        "presentationUnitAmount": 397,
                        "amount": 2,
                        "price": 45.6,
                        "unitPrice": 22.8
                    },
                    {
                        "supplyName": "Chile Chipotle.",
                        "supplyId": "IN-1732229437063",
                        "presentationUnit": "KILOGRAM",
                        "presentationUnitAmount": 3,
                        "amount": 1,
                        "price": 222,
                        "unitPrice": 222
                    },
                    {
                        "supplyName": "Maizena",
                        "supplyId": "IN-1732229437156",
                        "presentationUnit": "KILOGRAM",
                        "presentationUnitAmount": 1,
                        "amount": 3,
                        "price": 78,
                        "unitPrice": 26
                    },
                    {
                        "supplyName": "Jugo Naranja",
                        "supplyId": "IN-1732229437144",
                        "presentationUnit": "LITER",
                        "presentationUnitAmount": 1,
                        "amount": 12,
                        "price": 316.56,
                        "unitPrice": 26.38
                    },
                    {
                        "supplyName": "Jugo Piña",
                        "supplyId": "IN-1732229437146",
                        "presentationUnit": "LITER",
                        "presentationUnitAmount": 1,
                        "amount": 12,
                        "price": 316.56,
                        "unitPrice": 26.38
                    },
                    {
                        "supplyName": "Leche Carnation",
                        "supplyId": "IN-1732229437148",
                        "presentationUnit": "LITER",
                        "presentationUnitAmount": 1,
                        "amount": 24,
                        "price": 1296,
                        "unitPrice": 54
                    },
                    {
                        "supplyName": "Mango almibar",
                        "supplyId": "IN-1732229437160",
                        "presentationUnit": "GRAM",
                        "presentationUnitAmount": 820,
                        "amount": 2,
                        "price": 99.8,
                        "unitPrice": 49.9
                    },
                    {
                        "supplyName": "Maiz Pozole",
                        "supplyId": "IN-1732229437395",
                        "presentationUnit": "KILOGRAM",
                        "presentationUnitAmount": 3,
                        "amount": 2,
                        "price": 258,
                        "unitPrice": 129
                    },
                    {
                        "supplyName": "Azucar Splenda",
                        "supplyId": "IN-1732229437020",
                        "presentationUnit": "UNIT",
                        "presentationUnitAmount": 700,
                        "amount": 1,
     
Modified at 2026-02-08 21:53:18
Previous
List Supplies
Next
List Orders
Built with