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

# List receipts

`GET /v1/billing/invoices`

## Request

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

The orders behind the top-ups, newest first, as the merchant of record (Polar) holds them: this workspace's share of the billing customer's newest 100 orders. Empty before the first top-up.

## Response `200`

Recent paid orders (receipts). Empty when the org has never paid

- InvoiceList
  - `data` object[], required: Paid orders, newest first; empty before the first top-up.
    - `id` string, required: The Polar order id; what GET /v1/billing/invoices/{id}/url takes.
    - `createdAt` string, required: When the order was placed (ISO 8601).
    - `status` string, required: The order status as Polar reports it (paid, refunded, ...).
    - `paid` boolean, required: Whether the order was paid.
    - `totalAmount` integer, required: What was charged, in minor units of `currency`, tax included.
    - `currency` string, required: ISO 4217 currency of the order (usd).
    - `billingReason` string, nullable, required: Why the order exists, as Polar reports it (purchase, subscription_cycle, ...); null when it does not say.

## Other responses

- `401`: Missing or invalid credentials

---

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