---
title: "Print invoices in bulk"
description: "Starts a bulk PDF job for many invoices, as the Invoices page bulk print / download does: pick invoices by id or by the list filters, get one merged PDF (bundle) or a zip of single PDFs (separate). Returns 202 with a job"
url: https://docs.invoicefalcon.com/v3-reference/documents/print-invoices-in-bulk/
api: "API v3 reference"
method: POST
path: "/documents/bulk/print"
---

# Print invoices in bulk

`POST https://app.invoicefalcon.com/api/v3/external/documents/bulk/print`

Starts a bulk PDF job for many invoices, as the Invoices page bulk print / download does: pick invoices by id or by the list filters, get one merged PDF (bundle) or a zip of single PDFs (separate). Returns 202 with a job id; poll [`GET /documents/bulk/:job_id`](https://docs.invoicefalcon.com/v3-reference/documents/retrieve-a-bulk-job/) for progress and the download link.

**Note:** Asynchronous: only one bulk job may run per shop at a time (429 bulk_action_in_progress). Limited to 5,000 invoices. Free text search (q) is not supported here; use ids or date / status filters.

## Request body

- `ids` (array of integers): Invoice ids to include. Without ids the list filters below select the invoices.
- `document_type` (string): Which documents when filtering: 'invoice' (default), 'quote', 'credit_note' or 'pro_forma'. One of: `invoice`, `quote`, `credit_note`, `pro_forma`.
- `link` (string): 'linked' (created from a Shopify order), 'not_linked' (standalone) or 'trashed'. One of: `linked`, `not_linked`, `trashed`.
- `processing_type` (string): 'bundle' (one merged PDF, default) or 'separate' (zip of single PDFs). One of: `bundle`, `separate`.
- `delivery_method` (string): 'download' (default) or 'print', as the dashboard distinguishes them. One of: `print`, `download`.
- `status` (string): Shopify financial status of the order, one or many ('paid', 'pending').
- `from` (string): Created on or after this date (ISO 8601).
- `to` (string): Created on or before this date (ISO 8601).
- `template_name` (string): Template to render with (default 'default').

## Returns

- `job_id` (integer): e.g. `12`
- `status` (string): e.g. `pending`
- `count` (integer): e.g. `0`
- `kind` (string): e.g. `print`

Rate limit: this call costs 2 points ([rate limits](https://docs.invoicefalcon.com/v3/docs/api-v3/rate-limits/)).

## Examples

### One merged PDF of chosen invoices

```sh
curl -X POST "https://app.invoicefalcon.com/api/v3/external/documents/bulk/print" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "ids": [
      48213,
      48190,
      48177
    ]
  }'
```

### Zip of last month's paid invoices

```sh
curl -X POST "https://app.invoicefalcon.com/api/v3/external/documents/bulk/print" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "status": "paid",
    "from": "2026-02-01",
    "to": "2026-02-28",
    "processing_type": "separate",
    "template_name": "default"
  }'
```

### Every quote not linked to an order

```sh
curl -X POST "https://app.invoicefalcon.com/api/v3/external/documents/bulk/print" \
  -H "X-Auth-Token: $INVOICE_FALCON_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "document_type": "quote",
    "link": "not_linked"
  }'
```

## 200

The updated resource.

```json
{
  "job_id": 12,
  "status": "pending",
  "count": 0,
  "kind": "print"
}
```

## 202

Accepted: the job was queued. Poll the returned job id for progress.

```json
{
  "job_id": 12,
  "status": "pending",
  "count": 0,
  "kind": "print"
}
```

## 401

Missing or unknown `X-Auth-Token`, or the shop uninstalled the app.

```json
{
  "errors": [
    "Invalid API key"
  ],
  "code": "unauthorized"
}
```

## 403

`v3_required`: the shop still runs the previous dashboard. `paid_plan_required`: API access needs a paid plan.

```json
{
  "errors": [
    "API access requires a paid plan"
  ],
  "code": "paid_plan_required"
}
```

## 422

The request failed validation. Nothing was saved.

```json
{
  "errors": [
    "id is missing"
  ]
}
```

## 429

Rate limited: cost-weighted per key (reads cost less than writes). Wait `Retry-After` seconds; see `X-RateLimit-*` headers.

```json
{
  "errors": [
    "Rate limit exceeded"
  ],
  "code": "rate_limited"
}
```

