Skip to content

List invoices

GET/invoices

Costs 1 rate-limit point · Rate limits

Retrieve a paginated list of invoices. Supports filtering by document type, financial status, and date range.

Query parameters

  • invoice_typestring

    Filter by document type.

    One of invoicequotepro_forma
    Default "invoice"
  • financial_statusstring

    Filter by payment status.

    One of paidpendingpartially_paidpartially_refundedrefundedvoidedauthorized
  • created_at_minstring

    Filter invoices created on or after this date (YYYY-MM-DD).

  • created_at_maxstring

    Filter invoices created on or before this date (YYYY-MM-DD).

  • pageinteger

    Page number.

    Default 1
  • per_pageinteger

    Items per page (max 250).

    Default 25

Returns

  • invoicesarray of objects
    Show 12 child attributesHide child attributes
    • idinteger
      Example: 48213
    • slugstring

      Unique identifier for API calls.

    • numberstring

      Display number (e.g. INV-001).

    • invoice_typestring
      Example: invoice
      One of invoicequotepro_formashopify_order
    • total_pricestring

      Decimal string.

    • currencystring

      ISO 4217 code.

    • financial_statusstring
      Example: paid
    • order_namestring

      Shopify order name (e.g. #1042).

    • customer_namestring
      Example: Jane Doe
    • customer_emailstring
      Example: jane.doe@example.com
    • created_atstring
      Example: 2026-01-15T09:31:12Z
    • updated_atstring
      Example: 2026-01-15T09:31:40Z
  • metaobject
    Show 4 child attributesHide child attributes
    • totalinteger
      Example: 3
    • pageinteger
      Example: 1
    • per_pageinteger
      Example: 25
    • total_pagesinteger
      Example: 1

Errors

401

Missing or invalid API key.

403

The store is not on a paid plan. API access requires a paid Invoice Falcon plan.

429

Rate limit exceeded. Check X-RateLimit-Reset header.

GET/invoices
curl "https://app.invoicefalcon.com/api/v1/external/invoices" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY"
Response
{
  "invoices": [
    {
      "id": 48213,
      "slug": "k7xq2m9d4r",
      "number": "INV-1042",
      "invoice_type": "invoice",
      "total_price": "100.94",
      "currency": "USD",
      "financial_status": "paid",
      "order_name": "#1042",
      "customer_name": "Jane Doe",
      "customer_email": "jane.doe@example.com",
      "created_at": "2026-01-15T09:31:12Z",
      "updated_at": "2026-01-15T09:31:40Z"
    },
    {
      "id": 48190,
      "slug": "p3wz8c1n6t",
      "number": "INV-1041",
      "invoice_type": "invoice",
      "total_price": "58.50",
      "currency": "USD",
      "financial_status": "pending",
      "order_name": "#1041",
      "customer_name": "Sam Rivera",
      "customer_email": "sam.rivera@example.com",
      "created_at": "2026-01-14T09:31:12Z",
      "updated_at": "2026-01-14T09:31:40Z"
    },
    {
      "id": 48177,
      "slug": "d5hb0y7f2e",
      "number": "INV-1040",
      "invoice_type": "invoice",
      "total_price": "240.00",
      "currency": "USD",
      "financial_status": "paid",
      "order_name": "#1040",
      "customer_name": "Alex Chen",
      "customer_email": "alex.chen@example.com",
      "created_at": "2026-01-13T09:31:12Z",
      "updated_at": "2026-01-13T09:31:40Z"
    }
  ],
  "meta": {
    "total": 3,
    "page": 1,
    "per_page": 25,
    "total_pages": 1
  }
}