List Order Invoices - Parrot External API

This endpoint retrieves order invoices (facturas) by a given time range. NOTE, this will only include order invoices that users generated via Parrot's invoicing portal.

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

startTimestamp

string

required

Example:

2024-03-27T19:00:00-06:00

endTimestamp

string

required

Example:

2024-03-28T19:00:00-06:00

pageSize

integer

optional

Example:

100

page

string

optional

Example:

storeUUID

array[string]

optional

Example:

["a2f09385-7f1b-436c-9baa-bb9cf1174c25","206b8416-c3c8-4053-9bdf-a11f3ddd7da1"]

Request samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200OK

application/json

Body

pagination

object

required

null

required

null

required

count

integer

required

current

integer

required

pageSize

integer

required

data

array [object {7}]

required

uuid

string

required

orderUuid

string

required

createdAt

integer

required

total

integer

required

taxId

string

required

name

string

required

string

required

datetime

string

required

Example

{
  "pagination": {
    "next": null,
    "previous": null,
    "count": 1,
    "current": 0,
    "pageSize": 100
  },
  "data": [
    {
      "uuid": "d8d4fd9b-a70c-477f-aac5-9e6bc8d05aa6",
      "orderUuid": "04f7865e-7ed3-4c9f-b277-9fc8a24b132d",
      "createdAt": 1738620585,
      "total": 137,
      "taxId": "MMDG750726LF9",
      "name": "MAYRA MIRIAM MARTINEZ VILLARREAL",
      "email": "mayravillarreal@gmail.com"
    },
    {
      "uuid": "7a4b4e89-20b8-4a31-b080-f6c17790ca95",
      "orderUuid": "24feb928-8fbf-4a4d-a7bc-7f62c734493a",
      "createdAt": 1738710387,
      "total": 72,
      "taxId": "DDDL891817IZ9",
      "name": "LUIS DANIEL LEON MARTINEZ",
      "email": "luisdaniel@gmail.com"
    }
  ],
  "datetime": "2025-05-12T14:40:18-06:00"
}