curl "https://invoice.horizonpay.co/api/v1/invoices?status=open" \
  -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 invoice of invoiceai.invoices.list({ status: 'open' })) {
  console.log(invoice.number, invoice.amount_due)
}

from invoice_ai import InvoiceAI

client = InvoiceAI()  # reads INVOICE_AI_API_KEY

for invoice in client.invoices.list(status="open"):
    print(invoice.number, invoice.amount_due)

{
  "data": [
    {
      "id": "in_Pb2Xk7Mv4Qs9Lr1Wd6Tn3Fh8",
      "object": "invoice",
      "number": "INV-0042",
      "status": "open",
      "customer": "cus_Nf3kQ8pR2mX7vB1cT9wL4sZ6",
      "currency": "USD",
      "collection_method": "send_invoice",
      "issue_date": "2026-09-22",
      "due_date": "2026-10-22",
      "description": "Consulting retainer.",
      "footer": null,
      "subtotal": 2550000,
      "discount": 0,
      "taxable": 2550000,
      "tax": 0,
      "total": 2550000,
      "amount_due": 2550000,
      "amount_in_words": "Twenty Five Thousand Five Hundred USD Only",
      "public_url_token": "2b7e4c1a-9f3d-4e68-8a5b-0d1c7f3e9a46",
      "finalized_at": "2026-09-22T10:00:00.000Z",
      "paid_at": null,
      "voided_at": null,
      "void_reason": null,
      "created": "2026-09-22T09:30:00.000Z",
      "updated": "2026-09-22T10:00: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": "Client 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"
}