Retrieve quote
/documents/quotes/{id}Costs 1 rate-limit point · Rate limits
One quote in full: the invoice shape (numbers, dates, totals, customer, addresses, line items, PDF availability) plus the Shopify draft order gid and the payment link. 404 for an id that is not a quote; invoices and credit notes have their own reads. Read-only.
document_type values: invoice (Invoice), quote (Quote), credit_note (Credit note), pro_forma (Pro forma invoice), custom (Custom invoice).
financial_status values: pending (Payment pending), authorized (Authorized), partially_paid (Partially paid), paid (Paid), partially_refunded (Partially refunded), refunded (Refunded), voided (Voided), expired (Expired), cancelled (Cancelled).
Also searched asshow quotequote detailsopen quotewhat is on this quotequote pdf linkquote for draft order
Path parameters
idstringRequired
Returns
The document object.
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 resource does not exist for this shop, or no action is registered at this path.
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 "https://app.invoicefalcon.com/api/v3/external/documents/quotes/980191059" \
-H "X-Auth-Token: $INVOICE_FALCON_API_KEY"const res = await fetch("https://app.invoicefalcon.com/api/v3/external/documents/quotes/980191059", {
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/documents/quotes/980191059",
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/documents/quotes/980191059")
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){
"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"
}{
"errors": [
"Invalid API key"
],
"code": "unauthorized"
}{
"errors": [
"API access requires a paid plan"
],
"code": "paid_plan_required"
}{
"errors": [
"Resource not found"
],
"code": "not_found"
}{
"errors": [
"id is missing"
]
}{
"errors": [
"Rate limit exceeded"
],
"code": "rate_limited"
}