Skip to content

List invoices

GET/documents/invoices

Costs 1 rate-limit point · Rate limits

The invoices the V3 Invoices page lists, newest first, as list rows (number, order, customer, financial status, total, sent / printed / reminder timestamps). Invoices only by default; pass document_type to list quotes, credit notes or pro forma invoices from the same table. Trashed invoices are left out unless link=trashed. Read-only.

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

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

link values: linked (Created from a Shopify order), not_linked (Standalone (no Shopify order)), trashed (In the trash).

Also searched aslist invoicesshow my invoicesfind an invoicesearch invoicesunpaid invoicesinvoices for an orderinvoices from last monthtrashed invoices

Query parameters

  • document_typestring

    Which documents: 'invoice' (default), 'quote', 'credit_note', 'pro_forma', 'custom'. One of: invoice (Invoice), quote (Quote), credit_note (Credit note), pro_forma (Pro forma invoice), custom (Custom invoice).

    One of invoicequotecredit_notepro_formacustom
  • linkstring

    'linked' (created from a Shopify order), 'not_linked' (standalone) or 'trashed'. One of: linked (Created from a Shopify order), not_linked (Standalone (no Shopify order)), trashed (In the trash).

    One of linkednot_linkedtrashed
  • sortstring

    'created_at desc' (default) or 'created_at asc'.

    One of created_at desccreated_at asc
  • pageinteger

    1-based page number.

  • per_pageinteger

    Rows per page, default 25, max 100.

  • financial_statusstring

    Shopify financial status of the order, one or many ('paid', 'pending,partially_paid'). One of: pending (Payment pending), authorized (Authorized), partially_paid (Partially paid), paid (Paid), partially_refunded (Partially refunded), refunded (Refunded), voided (Voided), expired (Expired), cancelled (Cancelled).

    One of pendingauthorizedpartially_paidpaidpartially_refundedrefundedvoidedexpiredcancelled
  • fromstring

    Created on or after this date (ISO 8601).

  • tostring

    Created on or before this date (ISO 8601).

  • order_idstring

    The Shopify order, as a gid (gid://shopify/Order/123) or a bare number.

  • qstring

    Free text over invoice number, order name, customer name and email.

Returns

  • itemsarray of objects
    Show 19 child attributesHide child attributes
    • idinteger
      Example: 980191068
    • document_typestring
      Example: invoice
    • invoice_numberstring
      Example: #1001
    • titlestring
      Example: Invoice
    • orderobject
      Show 3 child attributesHide child attributes
      • shopify_order_idstring
        Example: gid://shopify/Order/12213474623569
      • namestring
        Example: #1001
      • numberinteger
        Example: 1001
    • customerobject
      Show 3 child attributesHide child attributes
      • idinteger
        Example: 43
      • namestring
        Example: Customer 1
      • emailstring
        Example: cus1@gmail.com
    • financial_statusstring
      Example: paid
    • currencystring
      Example: USD
    • totalstring
      Example: 1100.22
    • issued_onstring
      Example: 2025-12-11
    • due_onstring, nullable
    • sent_atstring, nullable
    • printed_atstring, nullable
    • reminder_sent_atstring, nullable
    • paidboolean
      Example: true
    • editedboolean
      Example: false
    • trashedboolean
      Example: true
    • e_invoice_statusstring, nullable
    • created_atstring
      Example: 2026-11-10T09:41:43Z
  • pageobject

    Offset paging of a list (page, per_page query params).

    Show 4 child attributesHide child attributes
    • numberinteger

      1-based page number.

    • sizeinteger

      Rows per page, max 100.

    • totalinteger

      Rows across all pages.

    • total_pagesinteger
      Example: 1

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.

Every error has the same shape: see Errors.

GET/documents/invoices
curl "https://app.invoicefalcon.com/api/v3/external/documents/invoices" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY"
Response
{
  "items": [
    {
      "id": 980191068,
      "document_type": "invoice",
      "invoice_number": "#1001",
      "title": "Invoice",
      "order": {
        "shopify_order_id": "gid://shopify/Order/12213474623569",
        "name": "#1001",
        "number": 1001
      },
      "customer": {
        "id": 43,
        "name": "Customer 1",
        "email": "cus1@gmail.com"
      },
      "financial_status": "paid",
      "currency": "USD",
      "total": "1100.22",
      "issued_on": "2025-12-11",
      "due_on": null,
      "sent_at": null,
      "printed_at": null,
      "reminder_sent_at": null,
      "paid": true,
      "edited": false,
      "trashed": true,
      "e_invoice_status": null,
      "created_at": "2026-11-10T09:41:43Z"
    }
  ],
  "page": {
    "number": 1,
    "size": 25,
    "total": 1,
    "total_pages": 1
  }
}