List orders Fileflare has processed, or fetch one order by its Fileflare order ID. Each order includes its order number, when it was placed and emailed, and optionally its attached assets.
Requires Bearer authentication with your Fileflare key. Rate-limited per store; the default is 60 requests per minute (a 429 response means you have hit it).
Endpoints
GET https://app.digital-downloads.com/api/v1/orders
GET https://app.digital-downloads.com/api/v1/orders/{order}
The single-order endpoint returns one order object (same fields as a list item, wrapped in data) and accepts only with_assets; page, limit and order_number apply to the list.
Parameters
Path
{order}— Fileflare’s order ID: theidfield from the list response, not the Shopify order ID (only for GET/orders/{order})
Query
page— page number (default1)limit— items per page (default100, max1000)order_number— exact match on Shopify’s sequential order number (order_numberin Shopify’s REST Admin API,numberin GraphQL). On stores with custom order names or migrated orders, this isn’t the number the Shopify admin shows, so get it from the Shopify Admin API.with_assets— bool (default:false) whether to show order-attached assets
Example request
curl "https://app.digital-downloads.com/api/v1/orders?with_assets=1" \
-H "Authorization: Bearer YOUR_API_KEY"
email_sent_at is null when no email has been sent. assets appears only with with_assets=1.
Example response — 200 OK
{
"data": [
{
"id": "9f2c1a3e-4b7d-4e21-8a6f-1c9d5e7b2f04",
"order_number": 1050,
"email_sent_at": 1767225600,
"ordered_at": 1767222000,
"assets": [
{
"id": "82664d96-6dfd-4343-96b0-05c46f412a5b",
"filename": "guide.pdf",
"size": "2.4 MB",
"raw_size": 2516582,
"is_file": true,
"is_link": false,
"url": null
}
]
}
],
"links": {"first": "https://app.digital-downloads.com/api/v1/orders?page=1", "last": "https://app.digital-downloads.com/api/v1/orders?page=11", "prev": null, "next": "https://app.digital-downloads.com/api/v1/orders?page=2"},
"meta": {"current_page": 1, "from": 1, "last_page": 11, "path": "https://app.digital-downloads.com/api/v1/orders", "per_page": 100, "to": 100, "total": 1042}
}
Common errors
- 401 — missing or invalid Bearer key.
- 404 — the order ID (the
idUUID from the list response, not the Shopify order ID) isn’t on your store. - 429 — rate limit reached; retry after a minute.