cURL
curl https://invoice.horizonpay.co/api/v1/prices \
-H "Authorization: Bearer $INVOICE_AI_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"product": "prod_Hy7Rq2Lm9Xc4Vb8Nt3Kd6Pw1",
"nickname": "Monthly",
"unit_amount": 2500000,
"currency": "USD",
"type": "recurring",
"recurring": { "interval": "month", "interval_count": 1 },
"tax_rate": 0
}'import InvoiceAI from '@horizonpay/invoice-ai'
const invoiceai = new InvoiceAI() // reads INVOICE_AI_API_KEY
const price = await invoiceai.prices.create({
product: 'prod_Hy7Rq2Lm9Xc4Vb8Nt3Kd6Pw1',
nickname: 'Monthly',
unit_amount: 2500000,
currency: 'USD',
type: 'recurring',
recurring: { interval: 'month', interval_count: 1 },
tax_rate: 0,
})
console.log(price.id)from invoice_ai import InvoiceAI
client = InvoiceAI() # reads INVOICE_AI_API_KEY
price = client.prices.create(
product="prod_Hy7Rq2Lm9Xc4Vb8Nt3Kd6Pw1",
nickname="Monthly",
unit_amount=2500000,
currency="USD",
type="recurring",
recurring={"interval": "month", "interval_count": 1},
tax_rate=0,
)
print(price.id){
"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"
}
}
Prices
Create a price
Adds a price to a product. unit_amount is in integer minor units. A recurring price needs recurring.interval; it is stored for reporting — nothing auto-bills yet.
Scope: products:write
Idempotency: Idempotency-Key optional. With one, a retry with the same key and body replays the first response (Idempotent-Replayed: true); the same key with a different body is a 422 idempotency_mismatch.
POST
/
prices
cURL
curl https://invoice.horizonpay.co/api/v1/prices \
-H "Authorization: Bearer $INVOICE_AI_API_KEY" \
-H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{
"product": "prod_Hy7Rq2Lm9Xc4Vb8Nt3Kd6Pw1",
"nickname": "Monthly",
"unit_amount": 2500000,
"currency": "USD",
"type": "recurring",
"recurring": { "interval": "month", "interval_count": 1 },
"tax_rate": 0
}'import InvoiceAI from '@horizonpay/invoice-ai'
const invoiceai = new InvoiceAI() // reads INVOICE_AI_API_KEY
const price = await invoiceai.prices.create({
product: 'prod_Hy7Rq2Lm9Xc4Vb8Nt3Kd6Pw1',
nickname: 'Monthly',
unit_amount: 2500000,
currency: 'USD',
type: 'recurring',
recurring: { interval: 'month', interval_count: 1 },
tax_rate: 0,
})
console.log(price.id)from invoice_ai import InvoiceAI
client = InvoiceAI() # reads INVOICE_AI_API_KEY
price = client.prices.create(
product="prod_Hy7Rq2Lm9Xc4Vb8Nt3Kd6Pw1",
nickname="Monthly",
unit_amount=2500000,
currency="USD",
type="recurring",
recurring={"interval": "month", "interval_count": 1},
tax_rate=0,
)
print(price.id){
"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"
}
}
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.
Headers
Body
application/json