---
title: "Orders"
description: "Orders: List orders, Retrieve order, Troubleshoot order, List drafts, Retrieve draft."
url: https://docs.invoicefalcon.com/v3-reference/orders/
api: "API v3 reference"
---

# Orders

## The order object

- `shopify_order_id` (string): e.g. `gid://shopify/Order/5551001`
- `kind` (string): e.g. `order`
- `order_number` (string): e.g. `#1001`
- `created_at` (string): e.g. `2026-03-01T10:00:00Z`
- `processed_at` (string): e.g. `2026-03-01T10:00:00Z`
- `financial_status` (string): e.g. `paid`
- `fulfillment_status` (string): e.g. `fulfilled`
- `currency` (string): e.g. `EUR`
- `total` (string): e.g. `120.50`
- `customer` (object)
  - `shopify_customer_id` (string): e.g. `gid://shopify/Customer/42`
  - `name` (string): e.g. `Ann Lee`
  - `email` (string): e.g. `ann@example.com`
  - `phone` (string, nullable)
  - `note` (string, nullable)
  - `default_address` (object, nullable)
- `invoice` (object)
  - `id` (integer): e.g. `980191041`
  - `type` (string): e.g. `invoice`
  - `number` (string): e.g. `INV-77`
  - `created_at` (string): e.g. `2026-11-10T09:24:20Z`
  - `sent_at` (string): e.g. `2026-03-02T10:00:00Z`
  - `printed_at` (string): e.g. `2026-03-03T10:00:00Z`
  - `downloaded_at` (string, nullable)
  - `reminder_sent_at` (string, nullable)
  - `e_invoice` (object)
    - `status` (object, nullable)
    - `error` (string, nullable)
    - `requested` (boolean): e.g. `false`
- `email` (string): e.g. `ann@example.com`
- `phone` (string, nullable)
- `note` (string): e.g. `Gift`
- `cancelled_at` (string, nullable)
- `totals` (object)
  - `subtotal` (string): e.g. `100.00`
  - `shipping` (string): e.g. `10.00`
  - `tax` (string): e.g. `10.50`
  - `discounts` (string): e.g. `0.00`
  - `total` (string): e.g. `120.50`
- `shipping_method` (string): e.g. `Standard`
- `billing_address` (object)
  - `name` (string): e.g. `Ann Lee`
  - `first_name` (string): e.g. `Ann`
  - `last_name` (string): e.g. `Lee`
  - `address1` (string): e.g. `1 Main St`
  - `address2` (string, nullable)
  - `city` (string): e.g. `Berlin`
  - `province` (string, nullable)
  - `province_code` (string, nullable)
  - `country` (string): e.g. `Germany`
  - `country_code` (string): e.g. `DE`
  - `zip` (string): e.g. `10115`
  - `phone` (string, nullable)
- `shipping_address` (object, nullable)
- `line_items` (array of objects)
  - `id` (string): e.g. `gid://shopify/LineItem/9`
  - `title` (string): e.g. `Hat`
  - `variant_title` (string): e.g. `Red`
  - `sku` (string): e.g. `HAT-R`
  - `barcode` (string, nullable)
  - `quantity` (integer): e.g. `2`
  - `unit_price` (string): e.g. `50.00`
  - `total` (string): e.g. `100.00`
  - `image_url` (string, nullable)
  - `selling_plan` (null)
  - `product_id` (string): e.g. `gid://shopify/Product/88`
  - `variant_id` (string): e.g. `gid://shopify/ProductVariant/77`
- `tax_lines` (array of objects)
  - `title` (string): e.g. `VAT`
  - `rate` (number): e.g. `0.19`
  - `amount` (string): e.g. `10.50`
- `documents` (array of objects)
  - `id` (integer): e.g. `980191041`
  - `type` (string): e.g. `invoice`
  - `number` (string): e.g. `INV-77`
  - `created_at` (string): e.g. `2026-11-10T09:24:20Z`
  - `sent_at` (string): e.g. `2026-03-02T10:00:00Z`
  - `printed_at` (string): e.g. `2026-03-03T10:00:00Z`
  - `downloaded_at` (string, nullable)
  - `reminder_sent_at` (string, nullable)
  - `paid_at` (string, nullable)
  - `pdf_ready` (boolean): e.g. `false`
  - `e_invoice` (object)
    - `status` (object, nullable)
    - `error` (string, nullable)
    - `requested` (boolean): e.g. `false`

```json
{
  "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": {
    "shopify_customer_id": "gid://shopify/Customer/42",
    "name": "Ann Lee",
    "email": "ann@example.com",
    "phone": null,
    "note": null,
    "default_address": null
  },
  "invoice": {
    "id": 980191041,
    "type": "invoice",
    "number": "INV-77",
    "created_at": "2026-11-10T09:24:20Z",
    "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
    }
  },
  "email": "ann@example.com",
  "phone": null,
  "note": "Gift",
  "cancelled_at": null,
  "totals": {
    "subtotal": "100.00",
    "shipping": "10.00",
    "tax": "10.50",
    "discounts": "0.00",
    "total": "120.50"
  },
  "shipping_method": "Standard",
  "billing_address": {
    "name": "Ann Lee",
    "first_name": "Ann",
    "last_name": "Lee",
    "address1": "1 Main St",
    "address2": null,
    "city": "Berlin",
    "province": null,
    "province_code": null,
    "country": "Germany",
    "country_code": "DE",
    "zip": "10115",
    "phone": null
  },
  "shipping_address": null,
  "line_items": [
    {
      "id": "gid://shopify/LineItem/9",
      "title": "Hat",
      "variant_title": "Red",
      "sku": "HAT-R",
      "barcode": null,
      "quantity": 2,
      "unit_price": "50.00",
      "total": "100.00",
      "image_url": null,
      "selling_plan": null,
      "product_id": "gid://shopify/Product/88",
      "variant_id": "gid://shopify/ProductVariant/77"
    }
  ],
  "tax_lines": [
    {
      "title": "VAT",
      "rate": 0.19,
      "amount": "10.50"
    }
  ],
  "documents": [
    {
      "id": 980191041,
      "type": "invoice",
      "number": "INV-77",
      "created_at": "2026-11-10T09:24:20Z",
      "sent_at": "2026-03-02T10:00:00Z",
      "printed_at": "2026-03-03T10:00:00Z",
      "downloaded_at": null,
      "reminder_sent_at": null,
      "paid_at": null,
      "pdf_ready": false,
      "e_invoice": {
        "status": null,
        "error": null,
        "requested": false
      }
    }
  ]
}
```

## Endpoints

- `GET /orders`: [List orders](https://docs.invoicefalcon.com/v3-reference/orders/list-orders.md)
- `GET /orders/{id}`: [Retrieve order](https://docs.invoicefalcon.com/v3-reference/orders/retrieve-order.md)
- `GET /orders/{id}/troubleshoot`: [Troubleshoot order](https://docs.invoicefalcon.com/v3-reference/orders/troubleshoot-order.md)
- `GET /orders/drafts`: [List drafts](https://docs.invoicefalcon.com/v3-reference/orders/list-drafts.md)
- `GET /orders/drafts/{id}`: [Retrieve draft](https://docs.invoicefalcon.com/v3-reference/orders/retrieve-draft.md)
