curl "https://invoice.horizonpay.co/api/v1/prices?product=prod_Hy7Rq2Lm9Xc4Vb8Nt3Kd6Pw1" \
-H "Authorization: Bearer $INVOICE_AI_API_KEY"import InvoiceAI from '@horizonpay/invoice-ai'
const invoiceai = new InvoiceAI() // reads INVOICE_AI_API_KEY
for await (const price of invoiceai.prices.list({
product: 'prod_Hy7Rq2Lm9Xc4Vb8Nt3Kd6Pw1',
})) {
console.log(price.id, price.unit_amount, price.currency)
}from invoice_ai import InvoiceAI
client = InvoiceAI() # reads INVOICE_AI_API_KEY
for price in client.prices.list(product="prod_Hy7Rq2Lm9Xc4Vb8Nt3Kd6Pw1"):
print(price.id, price.unit_amount, price.currency){
"data": [
{
"id": "price_Jc5Tn8Wq1Ze6Ra3Ym9Ub2Gs7",
"object": "price",
"product": "prod_Hy7Rq2Lm9Xc4Vb8Nt3Kd6Pw1",
"nickname": "Monthly",
"unit_amount": 2500000,
"currency": "USD",
"billing_scheme": "per_unit",
"type": "recurring",
"recurring": {
"interval": "month",
"interval_count": 1
},
"tax_rate": 0,
"active": true,
"created": "2026-09-22T09:30:00.000Z"
}
],
"next_cursor": null
}{
"type": "https://invoice.horizonpay.co/problems/unauthorized",
"title": "Unauthorized",
"status": 401,
"detail": "Send your API key as `Authorization: Bearer inv_live_…`.",
"instance": "req_7f3c9a1e2b4d4e8a9c6f2d1b0a3e5f71",
"code": "unauthorized"
}{
"type": "https://invoice.horizonpay.co/problems/forbidden",
"title": "Insufficient scope",
"status": 403,
"detail": "This credential is missing the invoices:write scope.",
"instance": "req_7f3c9a1e2b4d4e8a9c6f2d1b0a3e5f71",
"code": "forbidden"
}{
"type": "https://invoice.horizonpay.co/problems/not-found",
"title": "Not found",
"status": 404,
"detail": "Product not found.",
"instance": "req_7f3c9a1e2b4d4e8a9c6f2d1b0a3e5f71",
"code": "not_found"
}{
"type": "https://invoice.horizonpay.co/problems/validation",
"title": "Validation failed",
"status": 422,
"detail": "The cursor is not valid.",
"instance": "req_7f3c9a1e2b4d4e8a9c6f2d1b0a3e5f71",
"code": "validation",
"errors": [
{
"path": "cursor",
"message": "Pass the `next_cursor` from the previous page, unchanged."
}
]
}{
"type": "https://invoice.horizonpay.co/problems/rate-limited",
"title": "Too many requests",
"status": 429,
"detail": "Rate limit of 120 per 60s exceeded.",
"instance": "req_7f3c9a1e2b4d4e8a9c6f2d1b0a3e5f71",
"code": "rate_limited"
}List prices
Lists prices, newest first, optionally filtered by product, active, currency or type. An unknown product is a 404, not an empty page.
Scope: products:read
curl "https://invoice.horizonpay.co/api/v1/prices?product=prod_Hy7Rq2Lm9Xc4Vb8Nt3Kd6Pw1" \
-H "Authorization: Bearer $INVOICE_AI_API_KEY"import InvoiceAI from '@horizonpay/invoice-ai'
const invoiceai = new InvoiceAI() // reads INVOICE_AI_API_KEY
for await (const price of invoiceai.prices.list({
product: 'prod_Hy7Rq2Lm9Xc4Vb8Nt3Kd6Pw1',
})) {
console.log(price.id, price.unit_amount, price.currency)
}from invoice_ai import InvoiceAI
client = InvoiceAI() # reads INVOICE_AI_API_KEY
for price in client.prices.list(product="prod_Hy7Rq2Lm9Xc4Vb8Nt3Kd6Pw1"):
print(price.id, price.unit_amount, price.currency){
"data": [
{
"id": "price_Jc5Tn8Wq1Ze6Ra3Ym9Ub2Gs7",
"object": "price",
"product": "prod_Hy7Rq2Lm9Xc4Vb8Nt3Kd6Pw1",
"nickname": "Monthly",
"unit_amount": 2500000,
"currency": "USD",
"billing_scheme": "per_unit",
"type": "recurring",
"recurring": {
"interval": "month",
"interval_count": 1
},
"tax_rate": 0,
"active": true,
"created": "2026-09-22T09:30:00.000Z"
}
],
"next_cursor": null
}{
"type": "https://invoice.horizonpay.co/problems/unauthorized",
"title": "Unauthorized",
"status": 401,
"detail": "Send your API key as `Authorization: Bearer inv_live_…`.",
"instance": "req_7f3c9a1e2b4d4e8a9c6f2d1b0a3e5f71",
"code": "unauthorized"
}{
"type": "https://invoice.horizonpay.co/problems/forbidden",
"title": "Insufficient scope",
"status": 403,
"detail": "This credential is missing the invoices:write scope.",
"instance": "req_7f3c9a1e2b4d4e8a9c6f2d1b0a3e5f71",
"code": "forbidden"
}{
"type": "https://invoice.horizonpay.co/problems/not-found",
"title": "Not found",
"status": 404,
"detail": "Product not found.",
"instance": "req_7f3c9a1e2b4d4e8a9c6f2d1b0a3e5f71",
"code": "not_found"
}{
"type": "https://invoice.horizonpay.co/problems/validation",
"title": "Validation failed",
"status": 422,
"detail": "The cursor is not valid.",
"instance": "req_7f3c9a1e2b4d4e8a9c6f2d1b0a3e5f71",
"code": "validation",
"errors": [
{
"path": "cursor",
"message": "Pass the `next_cursor` from the previous page, unchanged."
}
]
}{
"type": "https://invoice.horizonpay.co/problems/rate-limited",
"title": "Too many requests",
"status": 429,
"detail": "Rate limit of 120 per 60s exceeded.",
"instance": "req_7f3c9a1e2b4d4e8a9c6f2d1b0a3e5f71",
"code": "rate_limited"
}Authorizations
An Invoice-AI API key sent as Authorization: Bearer inv_live_….
Create keys in Settings → API keys; the secret is shown once. Each key carries scopes, and every operation lists the scope it needs (x-required-scope):
business:read— Read your business profile, tax ID and bank detailsclients:read— List and read your clientsclients:write— Create, update and archive clientsproducts:read— List and read products and pricesproducts:write— Create, update and archive products and pricesinvoices:read— List and read invoices, including PDFsinvoices:write— Create, edit and delete draftsinvoices:finalize— Finalize invoices and void theminvoices:send— Email invoices to your clientspayments:write— Mark invoices as paidwebhooks:manage— Manage webhook endpoints
Keys cannot be created or revoked through the API, so a leaked key cannot mint more keys.
Query Parameters
The next_cursor from the previous page. Opaque — do not build it yourself.
Page size, 1–100. Defaults to 25.
1 <= x <= 100Only prices of this product, prod_… or UUID.
"prod_Hy7Rq2Lm9Xc4Vb8Nt3Kd6Pw1"
true for active prices only, false for archived only. Omit for both.
ISO 4217 code, case-insensitive.
"USD"
Only prices of this type. Other values are ignored.
one_time, recurring