Skip to main content
Use the invoice endpoints to collect invoices for bookkeeping, or to check whether anything is still unpaid.

List invoices

Invoices are returned newest first. Each invoice includes its number, status (open, paid, void, or uncollectible), totals in integer cents, and a hosted_invoice_url where it can be viewed and paid.
  • Add status=open to see what is still due.
  • When has_more is true, pass next_cursor as starting_after to get the next page.
  • limit accepts 1–100 and defaults to 25.

Download a PDF

The response is application/pdf. Content-Disposition names the file after the invoice number, and -OJ saves it under that name. If pdf_available is false, the request returns 409 not_available. Retry later or use hosted_invoice_url.

Download every invoice

Invoice PDF requests count toward the read rate limit. See rate limits.