---
title: "Stripe invoice history"
method: GET
path: "/account/invoices"
tags: ["Account & Billing"]
---

# Stripe invoice history

`GET /account/invoices`

Your account's billing history straight from Stripe — settled invoices plus the previewed upcoming charge for each live subscription — newest first. Drafts and voided invoices are excluded: they are not real payment history.

Read live from Stripe by customer rather than from Reacher's webhook-populated tables, so it cannot go stale when a webhook is missed. `amount` is in the minor units of the customer's Stripe billing currency (the currency itself is not carried on this surface). `invoice_pdf` links are Stripe-hosted and time-limited.

Account-scoped: invoices bill the account, not an individual shop, so the result is the same for any `x-shop-id`.

## Response `200`

Successful Response

- AccountInvoicesResponse
  - `has_stripe_customer` boolean, required — False when this account has never been billed through Stripe.
  - `data` AccountInvoice[], required
    - `id` string, required — Stripe invoice id, or `Upcoming-<subscription_id>` for the previewed next charge (which has no invoice yet).
    - `amount` integer, nullable — Invoice total in the minor units of the billing currency.
    - `status` string, nullable — Paid, Past Due, or Upcoming.
    - `due_date` string, nullable — Formatted as '01 Jan 2026'.
    - `billing_month` string, nullable — Formatted as 'January 2026'.
    - `plans` object — Plan name → seat quantity billed on this invoice.
    - `invoice_pdf` string, nullable — Stripe-hosted PDF link. Null for upcoming invoices, which do not exist as documents yet. The link is time-limited by Stripe.

## Changes

> 31 revisions in range; 1 not diffed.

- **2026-09-19** `291230805105` — 1 info
  - api operation id `account_invoices_account_invoices_get` removed and replaced with `account_invoices`

[Change history](https://skmtc.dev/reacherapp/apis/reacher-data-api/changes/account/invoices/get.md)

---

[API](https://skmtc.dev/reacherapp/apis/reacher-data-api.md) · [All operations](https://skmtc.dev/reacherapp/apis/reacher-data-api/llms.txt) · [OpenAPI document](https://skmtc.dev/reacherapp/apis/reacher-data-api/revisions/3530675d2c2a?raw)