Viewing orders

API reference for viewing and retrieving order data through the Fileflare API.

Beka Rice Avatar

Written by

Last updated


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: the id field from the list response, not the Shopify order ID (only for GET /orders/{order})

Query

  • page — page number (default 1)
  • limit — items per page (default 100, max 1000)
  • order_number — exact match on Shopify’s sequential order number (order_number in Shopify’s REST Admin API, number in 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 id UUID from the list response, not the Shopify order ID) isn’t on your store.
  • 429 — rate limit reached; retry after a minute.

Keep learning