Bills

Overview

Bills are Accounts Payable statements — amounts your business owes a vendor for goods or services. They are created and managed by account admins; these read-only endpoints let an authenticated vendor retrieve their own bills.

A vendor is a vendor-type user, not an end-user or subscriber. These endpoints are scoped to the authenticated vendor and return only that vendor's bills.

---

How It Works

1. List bills — retrieve the vendor's bills, most recent first, cursor-paginated at 25 per page.
2. Retrieve a bill — fetch a single bill by its ID.

---

API Endpoints

---

Important Behaviors

• Both endpoints require an authenticated vendor (Bearer JWT) and are scoped to that vendor — a bill issued to another vendor (or on another account) is never returned, and a direct lookup of one yields 404.
• Bills are created, finalized, and marked as paid by account admins; the Open API exposes read-only access for vendors.
• The list is cursor-paginated at 25 bills per page; follow meta.next_cursor to page through results.
• Bills are returned most recent first.
• status is an integer: 1 = paid, 2 = open (finalized, awaiting payment), 3 = draft.
• bill_pdf is a public URL to the rendered PDF.