---
title: "Documents"
description: "Documents: List bulk jobs, Retrieve a bulk job, Cancel a bulk job, Print invoices in bulk, Send invoices in bulk, List credit notes, Create credit note, Retrieve credit note, Delete credit note, Print credit note, Send c"
url: https://docs.invoicefalcon.com/v3-reference/documents/
api: "API v3 reference"
---

# Documents

## The document object

- `id` (integer): e.g. `980191059`
- `document_type` (string): e.g. `quote`
- `invoice_number` (string): e.g. `Q-1001`
- `title` (string): e.g. `Quote`
- `order` (object)
  - `shopify_order_id` (string): e.g. `gid://shopify/DraftOrder/990777`
  - `name` (string): e.g. `#D1001`
  - `number` (integer, nullable)
- `customer` (object)
  - `id` (integer, nullable)
  - `name` (string, nullable)
  - `email` (string): e.g. `quote@example.com`
  - `shopify_customer_id` (string, nullable)
  - `phone` (string, nullable)
  - `tax_number` (string, nullable)
  - `eori_number` (string, nullable)
  - `tags` (array of anys)
- `financial_status` (string, nullable)
- `currency` (string): e.g. `EUR`
- `total` (string): e.g. `50.00`
- `issued_on` (string): e.g. `2026-11-10`
- `due_on` (string, nullable)
- `sent_at` (string, nullable)
- `printed_at` (string, nullable)
- `reminder_sent_at` (string, nullable)
- `paid` (boolean): e.g. `false`
- `edited` (boolean): e.g. `true`
- `trashed` (boolean): e.g. `false`
- `e_invoice_status` (string, nullable)
- `created_at` (string): e.g. `2026-11-10T09:24:24Z`
- `shopify_draft_order_id` (string): e.g. `gid://shopify/DraftOrder/990777`
- `fulfillment_status` (string, nullable)
- `dates` (object)
  - `order_placed_at` (string, nullable)
  - `issued_on` (string): e.g. `2026-11-10`
  - `due_on` (string, nullable)
  - `tax_date` (string, nullable)
  - `fulfilled_on` (string, nullable)
- `po_number` (string, nullable)
- `payment_terms` (string, nullable)
- `payment_gateway` (string, nullable)
- `locale` (string, nullable)
- `totals` (object)
  - `currency` (string): e.g. `EUR`
  - `taxes_included` (boolean, nullable)
  - `subtotal` (string): e.g. `0.00`
  - `discounts` (string): e.g. `0.00`
  - `shipping` (string): e.g. `0.00`
  - `tax` (string): e.g. `0.00`
  - `duties` (string): e.g. `0.00`
  - `total` (string): e.g. `0.00`
  - `total_paid` (string): e.g. `0.00`
  - `total_refunded` (string): e.g. `0.00`
  - `total_due` (string): e.g. `0.00`
- `billing_address` (object, nullable)
- `shipping_address` (object, nullable)
- `line_items` (array of anys)
- `shipping_lines` (array of anys)
- `tax_lines` (array of anys)
- `discount_codes` (array of anys)
- `notes` (object)
  - `note` (string, nullable)
  - `custom_note` (string, nullable)
  - `note_attributes` (array of anys)
- `custom_fields` (array of anys)
- `tags` (array of anys)
- `tracking` (object)
  - `companies` (array of anys, nullable)
  - `numbers` (array of anys, nullable)
- `pdf` (object)
  - `available` (boolean): e.g. `false`
  - `filename` (string, nullable)
  - `url` (string, nullable)
  - `generated_at` (string, nullable)
- `e_invoice` (object)
  - `status` (object, nullable)
  - `requested` (boolean): e.g. `false`
  - `error` (string, nullable)
- `updated_at` (string): e.g. `2026-11-10T09:24:24Z`
- `payment_url` (string): e.g. `https://shop.example/pay/abc`

```json
{
  "id": 980191059,
  "document_type": "quote",
  "invoice_number": "Q-1001",
  "title": "Quote",
  "order": {
    "shopify_order_id": "gid://shopify/DraftOrder/990777",
    "name": "#D1001",
    "number": null
  },
  "customer": {
    "id": null,
    "name": null,
    "email": "quote@example.com",
    "shopify_customer_id": null,
    "phone": null,
    "tax_number": null,
    "eori_number": null,
    "tags": []
  },
  "financial_status": null,
  "currency": "EUR",
  "total": "50.00",
  "issued_on": "2026-11-10",
  "due_on": null,
  "sent_at": null,
  "printed_at": null,
  "reminder_sent_at": null,
  "paid": false,
  "edited": true,
  "trashed": false,
  "e_invoice_status": null,
  "created_at": "2026-11-10T09:24:24Z",
  "shopify_draft_order_id": "gid://shopify/DraftOrder/990777",
  "fulfillment_status": null,
  "dates": {
    "order_placed_at": null,
    "issued_on": "2026-11-10",
    "due_on": null,
    "tax_date": null,
    "fulfilled_on": null
  },
  "po_number": null,
  "payment_terms": null,
  "payment_gateway": null,
  "locale": null,
  "totals": {
    "currency": "EUR",
    "taxes_included": null,
    "subtotal": "0.00",
    "discounts": "0.00",
    "shipping": "0.00",
    "tax": "0.00",
    "duties": "0.00",
    "total": "0.00",
    "total_paid": "0.00",
    "total_refunded": "0.00",
    "total_due": "0.00"
  },
  "billing_address": null,
  "shipping_address": null,
  "line_items": [],
  "shipping_lines": [],
  "tax_lines": [],
  "discount_codes": [],
  "notes": {
    "note": null,
    "custom_note": null,
    "note_attributes": []
  },
  "custom_fields": [],
  "tags": [],
  "tracking": {
    "companies": null,
    "numbers": null
  },
  "pdf": {
    "available": false,
    "filename": null,
    "url": null,
    "generated_at": null
  },
  "e_invoice": {
    "status": null,
    "requested": false,
    "error": null
  },
  "updated_at": "2026-11-10T09:24:24Z",
  "payment_url": "https://shop.example/pay/abc"
}
```

## Endpoints

- `GET /documents/bulk`: [List bulk jobs](https://docs.invoicefalcon.com/v3-reference/documents/list-bulk-jobs.md)
- `GET /documents/bulk/{job_id}`: [Retrieve a bulk job](https://docs.invoicefalcon.com/v3-reference/documents/retrieve-a-bulk-job.md)
- `POST /documents/bulk/{job_id}/cancel`: [Cancel a bulk job](https://docs.invoicefalcon.com/v3-reference/documents/cancel-a-bulk-job.md)
- `POST /documents/bulk/print`: [Print invoices in bulk](https://docs.invoicefalcon.com/v3-reference/documents/print-invoices-in-bulk.md)
- `POST /documents/bulk/send`: [Send invoices in bulk](https://docs.invoicefalcon.com/v3-reference/documents/send-invoices-in-bulk.md)
- `GET /documents/credit_notes`: [List credit notes](https://docs.invoicefalcon.com/v3-reference/documents/list-credit-notes.md)
- `POST /documents/credit_notes`: [Create credit note](https://docs.invoicefalcon.com/v3-reference/documents/create-credit-note.md)
- `GET /documents/credit_notes/{id}`: [Retrieve credit note](https://docs.invoicefalcon.com/v3-reference/documents/retrieve-credit-note.md)
- `DELETE /documents/credit_notes/{id}`: [Delete credit note](https://docs.invoicefalcon.com/v3-reference/documents/delete-credit-note.md)
- `POST /documents/credit_notes/{id}/pdf`: [Print credit note](https://docs.invoicefalcon.com/v3-reference/documents/print-credit-note.md)
- `POST /documents/credit_notes/{id}/send`: [Send credit note](https://docs.invoicefalcon.com/v3-reference/documents/send-credit-note.md)
- `GET /documents/invoices`: [List invoices](https://docs.invoicefalcon.com/v3-reference/documents/list-invoices.md)
- `POST /documents/invoices`: [Create invoice](https://docs.invoicefalcon.com/v3-reference/documents/create-invoice.md)
- `GET /documents/invoices/{id}`: [Retrieve invoice](https://docs.invoicefalcon.com/v3-reference/documents/retrieve-invoice.md)
- `PATCH /documents/invoices/{id}`: [Update invoice](https://docs.invoicefalcon.com/v3-reference/documents/update-invoice.md)
- `DELETE /documents/invoices/{id}`: [Delete invoice](https://docs.invoicefalcon.com/v3-reference/documents/delete-invoice.md)
- `GET /documents/invoices/{id}/history`: [Invoice history](https://docs.invoicefalcon.com/v3-reference/documents/invoice-history.md)
- `POST /documents/invoices/{id}/mark_paid`: [Mark invoice paid](https://docs.invoicefalcon.com/v3-reference/documents/mark-invoice-paid.md)
- `POST /documents/invoices/{id}/mark_unpaid`: [Mark invoice unpaid](https://docs.invoicefalcon.com/v3-reference/documents/mark-invoice-unpaid.md)
- `POST /documents/invoices/{id}/pdf`: [Print invoice](https://docs.invoicefalcon.com/v3-reference/documents/print-invoice.md)
- `DELETE /documents/invoices/{id}/permanent`: [Destroy invoice](https://docs.invoicefalcon.com/v3-reference/documents/destroy-invoice.md)
- `POST /documents/invoices/{id}/restore`: [Restore invoice](https://docs.invoicefalcon.com/v3-reference/documents/restore-invoice.md)
- `POST /documents/invoices/{id}/send`: [Send invoice](https://docs.invoicefalcon.com/v3-reference/documents/send-invoice.md)
- `GET /documents/packing_slips/{invoice_id}`: [Retrieve packing slip](https://docs.invoicefalcon.com/v3-reference/documents/retrieve-packing-slip.md)
- `GET /documents/quotes`: [List quotes](https://docs.invoicefalcon.com/v3-reference/documents/list-quotes.md)
- `POST /documents/quotes`: [Create quote](https://docs.invoicefalcon.com/v3-reference/documents/create-quote.md)
- `GET /documents/quotes/{id}`: [Retrieve quote](https://docs.invoicefalcon.com/v3-reference/documents/retrieve-quote.md)
- `POST /documents/quotes/{id}/pdf`: [Print quote](https://docs.invoicefalcon.com/v3-reference/documents/print-quote.md)
- `POST /documents/quotes/{id}/send`: [Send quote](https://docs.invoicefalcon.com/v3-reference/documents/send-quote.md)
