---
title: "Invoices"
description: "List, create, search, and manage invoices."
url: https://docs.invoicefalcon.com/api/invoices/
api: "API v1 reference"
---

# Invoices

List, create, search, and manage invoices.

## The invoice object

- `invoice` (object)
  - `id` (integer): e.g. `48213`
  - `slug` (string): e.g. `k7xq2m9d4r`
  - `number` (string): e.g. `INV-1042`
  - `invoice_type` (string): e.g. `invoice`
  - `total_price` (string): e.g. `100.94`
  - `currency` (string): e.g. `USD`
  - `financial_status` (string): e.g. `paid`
  - `fulfillment_status` (string): e.g. `fulfilled`
  - `order_name` (string): e.g. `#1042`
  - `order_number` (integer): e.g. `1042`
  - `processed_at` (string): e.g. `2026-01-15T09:30:00Z`
  - `note` (string): e.g. `Please leave at the front desk.`
  - `created_at` (string): e.g. `2026-01-15T09:31:12Z`
  - `updated_at` (string): e.g. `2026-01-15T09:31:40Z`
  - `customer` (object)
    - `id` (integer): e.g. `9177`
    - `email` (string): e.g. `jane.doe@example.com`
    - `first_name` (string): e.g. `Jane`
    - `last_name` (string): e.g. `Doe`
  - `billing_address` (object)
    - `first_name` (string): e.g. `Jane`
    - `last_name` (string): e.g. `Doe`
    - `company` (string): e.g. `Doe Studio`
    - `address1` (string): e.g. `12 Example Street`
    - `address2` (string): e.g. `Suite 4`
    - `city` (string): e.g. `Springfield`
    - `province` (string): e.g. `Illinois`
    - `country` (string): e.g. `United States`
    - `zip` (string): e.g. `62701`
    - `phone` (string): e.g. `+1 555 010 0199`
  - `shipping_address` (object)
    - `first_name` (string): e.g. `Jane`
    - `last_name` (string): e.g. `Doe`
    - `company` (string)
    - `address1` (string): e.g. `12 Example Street`
    - `address2` (string)
    - `city` (string): e.g. `Springfield`
    - `province` (string): e.g. `Illinois`
    - `country` (string): e.g. `United States`
    - `zip` (string): e.g. `62701`
    - `phone` (string): e.g. `+1 555 010 0199`
  - `line_items` (array of objects)
    - `title` (string): e.g. `Canvas tote bag`
    - `variant_title` (string): e.g. `Natural / Large`
    - `quantity` (integer): e.g. `2`
    - `price` (string): e.g. `45.00`
    - `sku` (string): e.g. `TOTE-NAT-L`
  - `tax_lines` (array of objects)
    - `title` (string): Tax name (e.g. VAT, GST).
    - `rate` (number): Decimal rate (e.g. 0.2 for 20%).
    - `price` (string): e.g. `5.94`

```json
{
  "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"
      }
    ]
  }
}
```

## Endpoints

- `GET /invoices`: [List invoices](https://docs.invoicefalcon.com/api/invoices/list-invoices.md)
- `POST /invoices`: [Create an invoice](https://docs.invoicefalcon.com/api/invoices/create-an-invoice.md)
- `GET /invoices/search`: [Search invoices](https://docs.invoicefalcon.com/api/invoices/search-invoices.md)
- `GET /invoices/{slug}`: [Get an invoice](https://docs.invoicefalcon.com/api/invoices/get-an-invoice.md)
- `POST /invoices/{slug}/regenerate`: [Regenerate invoice from Shopify](https://docs.invoicefalcon.com/api/invoices/regenerate-invoice-from-shopify.md)
