Skip to content

Get an invoice

GET/invoices/{slug}

Costs 1 rate-limit point · Rate limits

Retrieve a single invoice by its slug. Returns full details including line items, tax lines, customer, and addresses.

Path parameters

  • slugstringRequired

    The invoice's unique slug (UUID).

Returns

The invoice object.

Errors

401

Missing or invalid API key.

403

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

404

Resource not found.

429

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

GET/invoices/{slug}
curl "https://app.invoicefalcon.com/api/v1/external/invoices/{slug}" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY"
Response
{
  "invoice": {
    "id": 48213,
    "slug": "k7xq2m9d4r",
    "number": "INV-1042",
    "invoice_type": "invoice",
    "total_price": "100.94",
    "currency": "USD",
    "financial_status": "paid",
    "fulfillment_status": "fulfilled",
    "order_name": "#1042",
    "order_number": 1042,
    "processed_at": "2026-01-15T09:30:00Z",
    "note": "Please leave at the front desk.",
    "created_at": "2026-01-15T09:31:12Z",
    "updated_at": "2026-01-15T09:31:40Z",
    "customer": {
      "id": 9177,
      "email": "jane.doe@example.com",
      "first_name": "Jane",
      "last_name": "Doe"
    },
    "billing_address": {
      "first_name": "Jane",
      "last_name": "Doe",
      "company": "Doe Studio",
      "address1": "12 Example Street",
      "address2": "Suite 4",
      "city": "Springfield",
      "province": "Illinois",
      "country": "United States",
      "zip": "62701",
      "phone": "+1 555 010 0199"
    },
    "shipping_address": {
      "first_name": "Jane",
      "last_name": "Doe",
      "company": null,
      "address1": "12 Example Street",
      "address2": null,
      "city": "Springfield",
      "province": "Illinois",
      "country": "United States",
      "zip": "62701",
      "phone": "+1 555 010 0199"
    },
    "line_items": [
      {
        "title": "Canvas tote bag",
        "variant_title": "Natural / Large",
        "quantity": 2,
        "price": "45.00",
        "sku": "TOTE-NAT-L"
      },
      {
        "title": "Gift wrapping",
        "variant_title": null,
        "quantity": 1,
        "price": "5.00",
        "sku": null
      }
    ],
    "tax_lines": [
      {
        "title": "State tax",
        "rate": 0.0625,
        "price": "5.94"
      }
    ]
  }
}