API for retrieving invoices

General
1

:rocket: Feature Request
Add an API to retrieve billing invoices programmatically.

:magnifying_glass_tilted_left: Problem Statement
Invoices are currently only accessible through the web dashboard or email. This prevents automation of accounting workflows, monthly reconciliation, and integration with internal finance systems. Manual downloads are slow, error-prone, and don’t scale.

:light_bulb: Proposed Solution
Introduce a Billing / Invoices API with the ability to:

  • List invoices (GET /v1/billing/invoices) with filters (date range, status).

  • Retrieve a single invoice (GET /v1/billing/invoices/{invoice_id}).

  • Download invoice PDFs via direct or pre-signed URLs.

  • Enforce proper permissions (e.g., billing.read scope).

Example use case:
A monthly automated job fetches all invoices, downloads PDFs, and syncs them to internal accounting tools.

:pushpin: API Impact

  • Affects the billing layer, not model APIs.

  • Requires new endpoints and possibly a new auth scope (billing.read).

  • No breaking changes to existing APIs.

:counterclockwise_arrows_button: Alternatives Considered

  • Manual dashboard downloads (slow, error-prone).

  • Email parsing (fragile).

  • Browser automation/scraping (insecure and brittle).
    None provides a reliable programmatic solution.

:paperclip: Additional Context
This would greatly improve financial automation for teams using usage-based billing.