---
title: "List receipts"
method: GET
path: "/v1/billing/invoices"
tags: ["Billing"]
---

# List receipts

`GET /v1/billing/invoices`

## Request

- Base URL: `https://api.rumoro.dev`
- URL: `https://api.rumoro.dev/v1/billing/invoices`
- Auth: HTTP bearer

Returns the top-up orders, latest first, as Polar, the merchant of record, stores them. You get this workspace's orders among the billing customer's latest 100. No orders exist before the first top-up.

## Response `200`

Receipts for paid orders. Empty before the first payment

- InvoiceList
  - `data` object[], required: Most recent paid orders first. None until the first top-up.
    - `id` string, required: Pass it to GET /v1/billing/invoices/{id}/url for the receipt.
    - `createdAt` string, required: Order date and time (ISO 8601).
    - `status` string, required: Polar's status for the order, such as paid or refunded.
    - `paid` boolean, required: True if the order is paid.
    - `totalAmount` integer, required: The amount charged including tax, in the smallest unit of `currency`.
    - `currency` string, required: The order's currency as an ISO 4217 code, such as usd.
    - `billingReason` string, nullable, required: Polar's reason for the order, such as purchase or subscription_cycle. Null when Polar gives none.

## Other responses

- `401`: The credential is missing or not valid

---

[API](https://skmtc.dev/rumoro/apis/rumoro-api.md) · [All operations](https://skmtc.dev/rumoro/apis/rumoro-api/llms.txt) · [OpenAPI document](https://skmtc.dev/rumoro/apis/rumoro-api/revisions/9ef63ea894d1?raw)