List drafts
/orders/draftsCosts 1 rate-limit point · Rate limits
The Shopify draft orders as the Draft orders tab lists them, newest first, each with the quote Invoice Falcon made for it (number, when it was sent, printed or downloaded) or invoice: null. Filters: draft status (open, invoice_sent, completed), a created date range and a free-text search. Pages by Shopify cursor. Read-only.
status values: open (Open), invoice_sent (Invoice sent), completed (Completed).
invoice.type values: invoice (Invoice), quote (Quote), pro_forma (Pro forma invoice), credit_note (Credit note), custom (Custom document).
Also searched aslist draft ordersshow draftsopen quotesdraft orders without a quoterecent draftswhich drafts got a quote
Query parameters
per_pageintegerRows per page, 1-100 (default 25).
afterstringCursor of the last row of the previous page (page.end_cursor), to go forward.
beforestringCursor of the first row of the next page (page.start_cursor), to go back.
qstringFree text, in Shopify order search syntax: an order number ("#1001"), a customer name or email, or a field filter ("tag:wholesale", "sku:ABC").
created_at_minstringOnly orders created on or after this date (YYYY-MM-DD, shop time zone).
created_at_maxstringOnly orders created on or before this date (YYYY-MM-DD, shop time zone).
statusstringDraft status filter: open, invoice_sent, completed. One of:
open(Open),invoice_sent(Invoice sent),completed(Completed).One ofopeninvoice_sentcompleted
Returns
itemsarray of objectsShow 12 child attributesHide child attributes
shopify_draft_order_idstringExample:gid://shopify/DraftOrder/700kindstringExample:draft_orderorder_numberstringExample:#D1created_atstringExample:2026-03-01T10:00:00Zprocessed_atstringExample:2026-03-01T10:00:00Zfinancial_statusstringExample:paidstatusstringExample:opencurrencystringExample:EURtotalstringExample:120.50customerobjectShow 2 child attributesHide child attributes
namestringExample:Ann LeeemailstringExample:ann@example.com
invoiceobjectShow 8 child attributesHide child attributes
idintegerExample:980191038typestringExample:quotenumberstringExample:Q-1created_atstringExample:2026-11-10T09:24:20Zsent_atstring, nullableprinted_atstring, nullabledownloaded_atstring, nullablereminder_sent_atstring, nullable
cursorstringExample:cur700
pageobjectCursor paging of a Shopify-backed list: pass
end_cursorasafterfor the next page.Show 6 child attributesHide child attributes
sizeintegerExample:25has_next_pagebooleanExample:falsehas_previous_pagebooleanExample:falsestart_cursorstring, nullableend_cursorstring, nullabletotalinteger, nullableExample:1
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.
Shopify did not answer or returned an error (shopify_error). Retry later.
Every error has the same shape: see Errors.
curl "https://app.invoicefalcon.com/api/v3/external/orders/drafts" \
-H "X-Auth-Token: $INVOICE_FALCON_API_KEY"const res = await fetch("https://app.invoicefalcon.com/api/v3/external/orders/drafts", {
headers: {
"X-Auth-Token": process.env.INVOICE_FALCON_API_KEY,
},
});
const data = await res.json();import os
import requests
res = requests.get(
"https://app.invoicefalcon.com/api/v3/external/orders/drafts",
headers={"X-Auth-Token": os.environ["INVOICE_FALCON_API_KEY"]},
)
data = res.json()require "net/http"
require "json"
uri = URI("https://app.invoicefalcon.com/api/v3/external/orders/drafts")
req = Net::HTTP::Get.new(uri, "X-Auth-Token" => ENV["INVOICE_FALCON_API_KEY"])
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body)curl "https://app.invoicefalcon.com/api/v3/external/orders/drafts?status=open" \
-H "X-Auth-Token: $INVOICE_FALCON_API_KEY"const res = await fetch("https://app.invoicefalcon.com/api/v3/external/orders/drafts?status=open", {
headers: {
"X-Auth-Token": process.env.INVOICE_FALCON_API_KEY,
},
});
const data = await res.json();import os
import requests
res = requests.get(
"https://app.invoicefalcon.com/api/v3/external/orders/drafts?status=open",
headers={"X-Auth-Token": os.environ["INVOICE_FALCON_API_KEY"]},
)
data = res.json()require "net/http"
require "json"
uri = URI("https://app.invoicefalcon.com/api/v3/external/orders/drafts?status=open")
req = Net::HTTP::Get.new(uri, "X-Auth-Token" => ENV["INVOICE_FALCON_API_KEY"])
res = Net::HTTP.start(uri.host, uri.port, use_ssl: true) { |http| http.request(req) }
data = JSON.parse(res.body){
"items": [
{
"shopify_draft_order_id": "gid://shopify/DraftOrder/700",
"kind": "draft_order",
"order_number": "#D1",
"created_at": "2026-03-01T10:00:00Z",
"processed_at": "2026-03-01T10:00:00Z",
"financial_status": "paid",
"status": "open",
"currency": "EUR",
"total": "120.50",
"customer": {
"name": "Ann Lee",
"email": "ann@example.com"
},
"invoice": {
"id": 980191038,
"type": "quote",
"number": "Q-1",
"created_at": "2026-11-10T09:24:20Z",
"sent_at": null,
"printed_at": null,
"downloaded_at": null,
"reminder_sent_at": null
},
"cursor": "cur700"
}
],
"page": {
"size": 25,
"has_next_page": false,
"has_previous_page": false,
"start_cursor": null,
"end_cursor": null,
"total": 1
}
}{
"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"
}{
"errors": [
"Shopify did not return the orders: no response"
],
"code": "shopify_error"
}