Skip to content

List orders

GET/orders

Costs 1 rate-limit point · Rate limits

The Shopify orders of the store as the Orders page lists them, newest first, each with the Invoice Falcon invoice that exists for it (number, when it was sent, printed or downloaded, e-invoice state) or invoice: null when none was made yet. Filters match the page: payment status, fulfillment status, a created date range and a free-text search. Pages by Shopify cursor: pass page.end_cursor as after for the next page. Read-only; it never creates invoices.

financial_status values: paid (Paid), pending (Pending), refunded (Refunded), partially_paid (Partially paid), partially_refunded (Partially refunded), authorized (Authorized), voided (Voided), expired (Expired).

fulfillment_status values: fulfilled (Fulfilled), unfulfilled (Unfulfilled), partially_fulfilled (Partially fulfilled), in_progress (In progress), on_hold (On hold), pending_fulfillment (Pending), scheduled (Scheduled), restocked (Restocked).

invoice.type values: invoice (Invoice), quote (Quote), pro_forma (Pro forma invoice), credit_note (Credit note), custom (Custom document).

invoice.e_invoice.status values: generated (E-invoice embedded), fallback (Standard PDF), requested (Requested).

Also searched aslist ordersshow my ordersrecent ordersorders without an invoiceunpaid ordersorders from last weekfind orderwhich orders were invoiced

Query parameters

  • per_pageinteger

    Rows per page, 1-100 (default 25).

  • afterstring

    Cursor of the last row of the previous page (page.end_cursor), to go forward.

  • beforestring

    Cursor of the first row of the next page (page.start_cursor), to go back.

  • qstring

    Free text, in Shopify order search syntax: an order number ("#1001"), a customer name or email, or a field filter ("tag:wholesale", "sku:ABC").

  • created_at_minstring

    Only orders created on or after this date (YYYY-MM-DD, shop time zone).

  • created_at_maxstring

    Only orders created on or before this date (YYYY-MM-DD, shop time zone).

  • financial_statusstring

    Payment status filter: paid, pending, refunded, partially_paid, authorized, voided. One of: paid (Paid), pending (Pending), refunded (Refunded), partially_paid (Partially paid), partially_refunded (Partially refunded), authorized (Authorized), voided (Voided), expired (Expired).

    One of paidpendingrefundedpartially_paidpartially_refundedauthorizedvoidedexpired
  • fulfillment_statusstring

    Fulfillment filter: shipped, unshipped, partial, in_progress, on_hold (shipped = fulfilled, unshipped = unfulfilled). One of: fulfilled (Fulfilled), unfulfilled (Unfulfilled), partially_fulfilled (Partially fulfilled), in_progress (In progress), on_hold (On hold), pending_fulfillment (Pending), scheduled (Scheduled), restocked (Restocked).

    One of fulfilledunfulfilledpartially_fulfilledin_progresson_holdpending_fulfillmentscheduledrestocked

Returns

  • itemsarray of objects
    Show 12 child attributesHide child attributes
    • shopify_order_idstring
      Example: gid://shopify/Order/5551001
    • kindstring
      Example: order
    • order_numberstring
      Example: #1001
    • created_atstring
      Example: 2026-03-01T10:00:00Z
    • processed_atstring
      Example: 2026-03-01T10:00:00Z
    • financial_statusstring
      Example: paid
    • fulfillment_statusstring
      Example: fulfilled
    • currencystring
      Example: EUR
    • totalstring
      Example: 120.50
    • customerobject
      Show 2 child attributesHide child attributes
      • namestring
        Example: Ann Lee
      • emailstring
        Example: ann@example.com
    • invoiceobject
      Show 9 child attributesHide child attributes
      • idinteger
        Example: 980191045
      • typestring
        Example: invoice
      • numberstring
        Example: INV-77
      • created_atstring
        Example: 2026-11-10T09:24:21Z
      • sent_atstring
        Example: 2026-03-02T10:00:00Z
      • printed_atstring
        Example: 2026-03-03T10:00:00Z
      • downloaded_atstring, nullable
      • reminder_sent_atstring, nullable
      • e_invoiceobject
        Show 3 child attributesHide child attributes
        • statusobject, nullable
        • errorstring, nullable
        • requestedboolean
          Example: false
    • cursorstring
      Example: cur5551001
  • pageobject

    Cursor paging of a Shopify-backed list: pass end_cursor as after for the next page.

    Show 6 child attributesHide child attributes
    • sizeinteger
      Example: 25
    • has_next_pageboolean
      Example: true
    • has_previous_pageboolean
      Example: false
    • start_cursorstring, nullable
      Example: a
    • end_cursorstring, nullable
      Example: z
    • totalinteger, nullable
      Example: 2

Errors

401

Missing or unknown X-Auth-Token, or the shop uninstalled the app.

403

v3_required: the shop still runs the previous dashboard. paid_plan_required: API access needs a paid plan.

422

The request failed validation. Nothing was saved.

429

Rate limited: cost-weighted per key (reads cost less than writes). Wait Retry-After seconds; see X-RateLimit-* headers.

502

Shopify did not answer or returned an error (shopify_error). Retry later.

Every error has the same shape: see Errors.

GET/orders
curl "https://app.invoicefalcon.com/api/v3/external/orders" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY"
Response
{
  "items": [
    {
      "shopify_order_id": "gid://shopify/Order/5551001",
      "kind": "order",
      "order_number": "#1001",
      "created_at": "2026-03-01T10:00:00Z",
      "processed_at": "2026-03-01T10:00:00Z",
      "financial_status": "paid",
      "fulfillment_status": "fulfilled",
      "currency": "EUR",
      "total": "120.50",
      "customer": {
        "name": "Ann Lee",
        "email": "ann@example.com"
      },
      "invoice": {
        "id": 980191045,
        "type": "invoice",
        "number": "INV-77",
        "created_at": "2026-11-10T09:24:21Z",
        "sent_at": "2026-03-02T10:00:00Z",
        "printed_at": "2026-03-03T10:00:00Z",
        "downloaded_at": null,
        "reminder_sent_at": null,
        "e_invoice": {
          "status": null,
          "error": null,
          "requested": false
        }
      },
      "cursor": "cur5551001"
    },
    {
      "shopify_order_id": "gid://shopify/Order/5551002",
      "kind": "order",
      "order_number": "#1002",
      "created_at": "2026-03-01T10:00:00Z",
      "processed_at": "2026-03-01T10:00:00Z",
      "financial_status": "paid",
      "fulfillment_status": "fulfilled",
      "currency": "EUR",
      "total": "120.50",
      "customer": {
        "name": "Ann Lee",
        "email": "ann@example.com"
      },
      "invoice": null,
      "cursor": "cur5551002"
    }
  ],
  "page": {
    "size": 25,
    "has_next_page": true,
    "has_previous_page": false,
    "start_cursor": "a",
    "end_cursor": "z",
    "total": 2
  }
}