Skip to content

Create an invoice

POST/invoices

Costs 2 rate-limit points · Rate limits

Create (or retrieve) an invoice from a Shopify order ID. If the invoice already exists, it is returned. Optionally generates the PDF immediately.

Request body

  • order_idintegerRequired

    Shopify order or draft order ID.

  • draftboolean

    Set true for draft orders (quotes/pro-formas).

    Default false
  • generate_pdfboolean

    Whether to generate the PDF immediately.

    Default true
  • template_idinteger

    Optional template ID for PDF generation.

  • packing_slipboolean

    Generate the packing slip instead of the invoice. Inferred automatically when template_id points at a packing slip template.

    Default false

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.

422

Request could not be processed.

429

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

POST/invoices
curl -X POST "https://app.invoicefalcon.com/api/v1/external/invoices" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "order_id": 5873241604411
  }'
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"
      }
    ]
  }
}