Get an invoice
GET
/invoices/{slug}Costs 1 rate-limit point · Rate limits
Retrieve a single invoice by its slug. Returns full details including line items, tax lines, customer, and addresses.
Path parameters
slugstringRequiredThe invoice's unique slug (UUID).
Returns
The invoice object.
Errors
401
Missing or invalid API key.
403
The store is not on a paid plan. API access requires a paid Invoice Falcon plan.
404
Resource not found.
429
Rate limit exceeded. Check X-RateLimit-Reset header.
GET/invoices/{slug}
curl "https://app.invoicefalcon.com/api/v1/external/invoices/{slug}" \
-H "X-Auth-Token: $INVOICE_FALCON_API_KEY"const res = await fetch("https://app.invoicefalcon.com/api/v1/external/invoices/{slug}", {
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/v1/external/invoices/{slug}",
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/v1/external/invoices/{slug}")
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)Response
{
"invoice": {
"id": 48213,
"slug": "k7xq2m9d4r",
"number": "INV-1042",
"invoice_type": "invoice",
"total_price": "100.94",
"currency": "USD",
"financial_status": "paid",
"fulfillment_status": "fulfilled",
"order_name": "#1042",
"order_number": 1042,
"processed_at": "2026-01-15T09:30:00Z",
"note": "Please leave at the front desk.",
"created_at": "2026-01-15T09:31:12Z",
"updated_at": "2026-01-15T09:31:40Z",
"customer": {
"id": 9177,
"email": "jane.doe@example.com",
"first_name": "Jane",
"last_name": "Doe"
},
"billing_address": {
"first_name": "Jane",
"last_name": "Doe",
"company": "Doe Studio",
"address1": "12 Example Street",
"address2": "Suite 4",
"city": "Springfield",
"province": "Illinois",
"country": "United States",
"zip": "62701",
"phone": "+1 555 010 0199"
},
"shipping_address": {
"first_name": "Jane",
"last_name": "Doe",
"company": null,
"address1": "12 Example Street",
"address2": null,
"city": "Springfield",
"province": "Illinois",
"country": "United States",
"zip": "62701",
"phone": "+1 555 010 0199"
},
"line_items": [
{
"title": "Canvas tote bag",
"variant_title": "Natural / Large",
"quantity": 2,
"price": "45.00",
"sku": "TOTE-NAT-L"
},
{
"title": "Gift wrapping",
"variant_title": null,
"quantity": 1,
"price": "5.00",
"sku": null
}
],
"tax_lines": [
{
"title": "State tax",
"rate": 0.0625,
"price": "5.94"
}
]
}
}{
"error": "Invalid API key"
}{
"error": "REST API access requires a paid plan"
}{
"error": "Not found"
}{
"error": "Rate limit exceeded",
"retry_after": 30,
"message": "You have exceeded the rate limit of 40 points per 60 seconds. Read requests cost 1 point(s) and write requests cost 2 point(s). Please retry after 30 second(s)."
}