Print invoices in bulk
/documents/bulk/printCosts 2 rate-limit points · Rate limits
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 for progress and the download link.
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.
Also searched asbulk print invoicesdownload many invoicesexport invoices as pdfprint all invoiceszip of invoicesprint invoices for a date rangedownload last month invoices
Request body
idsarray of integersInvoice ids to include. Without ids the list filters below select the invoices.
document_typestringWhich documents when filtering: 'invoice' (default), 'quote', 'credit_note' or 'pro_forma'.
One ofinvoicequotecredit_notepro_formalinkstring'linked' (created from a Shopify order), 'not_linked' (standalone) or 'trashed'.
One oflinkednot_linkedtrashedprocessing_typestring'bundle' (one merged PDF, default) or 'separate' (zip of single PDFs).
One ofbundleseparatedelivery_methodstring'download' (default) or 'print', as the dashboard distinguishes them.
One ofprintdownloadstatusstringShopify financial status of the order, one or many ('paid', 'pending').
fromstringCreated on or after this date (ISO 8601).
tostringCreated on or before this date (ISO 8601).
template_namestringTemplate to render with (default 'default').
Returns
job_idintegerExample:12statusstringExample:pendingcountintegerExample:0kindstringExample:print
Errors
Missing or unknown X-Auth-Token, or the shop uninstalled the app.
v3_required: the shop still runs the previous dashboard. paid_plan_required: API access needs a paid plan.
The request failed validation. Nothing was saved.
Rate limited: cost-weighted per key (reads cost less than writes). Wait Retry-After seconds; see X-RateLimit-* headers.
Every error has the same shape: see Errors.
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
]
}'const res = await fetch("https://app.invoicefalcon.com/api/v3/external/documents/bulk/print", {
method: "POST",
headers: {
"X-Auth-Token": process.env.INVOICE_FALCON_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"ids": [
48213,
48190,
48177
]
}),
});
const data = await res.json();import os
import requests
res = requests.post(
"https://app.invoicefalcon.com/api/v3/external/documents/bulk/print",
headers={"X-Auth-Token": os.environ["INVOICE_FALCON_API_KEY"]},
json={
"ids": [
48213,
48190,
48177
]
},
)
data = res.json()require "net/http"
require "json"
uri = URI("https://app.invoicefalcon.com/api/v3/external/documents/bulk/print")
req = Net::HTTP::Post.new(uri, "X-Auth-Token" => ENV["INVOICE_FALCON_API_KEY"], "Content-Type" => "application/json")
req.body = {
ids: [
48213,
48190,
48177
]
}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body)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"
}'const res = await fetch("https://app.invoicefalcon.com/api/v3/external/documents/bulk/print", {
method: "POST",
headers: {
"X-Auth-Token": process.env.INVOICE_FALCON_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"status": "paid",
"from": "2026-02-01",
"to": "2026-02-28",
"processing_type": "separate",
"template_name": "default"
}),
});
const data = await res.json();import os
import requests
res = requests.post(
"https://app.invoicefalcon.com/api/v3/external/documents/bulk/print",
headers={"X-Auth-Token": os.environ["INVOICE_FALCON_API_KEY"]},
json={
"status": "paid",
"from": "2026-02-01",
"to": "2026-02-28",
"processing_type": "separate",
"template_name": "default"
},
)
data = res.json()require "net/http"
require "json"
uri = URI("https://app.invoicefalcon.com/api/v3/external/documents/bulk/print")
req = Net::HTTP::Post.new(uri, "X-Auth-Token" => ENV["INVOICE_FALCON_API_KEY"], "Content-Type" => "application/json")
req.body = {
status: "paid",
from: "2026-02-01",
to: "2026-02-28",
processing_type: "separate",
template_name: "default"
}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body)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"
}'const res = await fetch("https://app.invoicefalcon.com/api/v3/external/documents/bulk/print", {
method: "POST",
headers: {
"X-Auth-Token": process.env.INVOICE_FALCON_API_KEY,
"Content-Type": "application/json",
},
body: JSON.stringify({
"document_type": "quote",
"link": "not_linked"
}),
});
const data = await res.json();import os
import requests
res = requests.post(
"https://app.invoicefalcon.com/api/v3/external/documents/bulk/print",
headers={"X-Auth-Token": os.environ["INVOICE_FALCON_API_KEY"]},
json={
"document_type": "quote",
"link": "not_linked"
},
)
data = res.json()require "net/http"
require "json"
uri = URI("https://app.invoicefalcon.com/api/v3/external/documents/bulk/print")
req = Net::HTTP::Post.new(uri, "X-Auth-Token" => ENV["INVOICE_FALCON_API_KEY"], "Content-Type" => "application/json")
req.body = {
document_type: "quote",
link: "not_linked"
}.to_json
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body){
"job_id": 12,
"status": "pending",
"count": 0,
"kind": "print"
}{
"job_id": 12,
"status": "pending",
"count": 0,
"kind": "print"
}{
"errors": [
"Invalid API key"
],
"code": "unauthorized"
}{
"errors": [
"API access requires a paid plan"
],
"code": "paid_plan_required"
}{
"errors": [
"id is missing"
]
}{
"errors": [
"Rate limit exceeded"
],
"code": "rate_limited"
}