# API for retrieving invoices

**URL:** <https://community.perplexity.ai/t/api-for-retrieving-invoices/2936>\
**Category:** General\
**Tags:** search-api\
**Created:** [December 4, 2025, 8:34am UTC](https://community.perplexity.ai/t/api-for-retrieving-invoices/2936 "2025-12-04T08:34:08Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![Amit\_Bar](https://sea1.discourse-cdn.com/flex001/user_avatar/community.perplexity.ai/amit_bar/32/521_2.png) [@Amit\_Bar](https://community.perplexity.ai/u/Amit_Bar)\
**Post date:** [December 4, 2025, 8:34am UTC](https://community.perplexity.ai/t/api-for-retrieving-invoices/2936/1 "2025-12-04T08:34:08Z")

</div>

🚀 **Feature Request**  
Add an API to retrieve billing invoices programmatically.

* * *

🔍 **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.

* * *

💡 **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.

* * *

📌 **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.

* * *

🔄 **Alternatives Considered**

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

- Email parsing (fragile).

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

* * *

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