---
title: "List Stripe invoice projections"
method: GET
path: "/billing/invoices"
tags: ["Billing"]
---

# List Stripe invoice projections

`GET /billing/invoices`

## Request

- Base URL: `https://api.flashdata.dev/v2`
- URL: `https://api.flashdata.dev/v2/billing/invoices`
- Auth: API key in cookie `__Host-fd_session`

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

Invoices

- object
  - `data` Invoice[], required
    - `id` string, required
    - `number` string, required
    - `status` 'draft' | 'open' | 'paid' | 'void' | 'uncollectible', required
    - `currency` 'USD', required
    - `total` integer, required: USD cents
    - `amountPaid` integer, required: USD cents
    - `refundedAmount` integer, required: Cumulative USD cents observed from verified provider events.
    - `billingReason` 'subscription_create' | 'subscription_cycle' | 'subscription_update' | 'null', nullable, required
    - `hostedInvoiceUrl` string, uri, nullable: Stripe-hosted HTTPS invoice URL. Production Web clients accept only Stripe-controlled *.stripe.com origins.
    - `createdAt` string, date-time, required
    - `paidAt` string, date-time, nullable
    - `periodStart` string, date-time, nullable, required
    - `periodEnd` string, date-time, nullable, required
  - `pagination` Pagination, required
    - `nextCursor` string, nullable
    - `previousCursor` string, nullable
    - `hasMore` boolean, required
    - `limit` integer, required

## Other responses

- `401`: Authentication required or invalid

---

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