---
title: "List account-scoped top-up and refund payment projections"
method: GET
path: "/billing/payments"
tags: ["Billing"]
---

# List account-scoped top-up and refund payment projections

`GET /billing/payments`

## Request

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

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

One-time payment history without provider secrets

- BillingPaymentPage
  - `data` BillingPayment[], required
    - `id` string, required
    - `purchaseType` 'top_up', required
    - `status` 'pending' | 'paid' | 'partially_refunded' | 'refunded' | 'failed', required
    - `currency` 'USD', required
    - `amount` integer, required: USD cents
    - `refundedAmount` integer, required: USD cents
    - `credits` number, required
    - `hostedInvoiceUrl` string, uri, nullable: Stripe-hosted HTTPS invoice URL, when Stripe created an invoice for this top-up.
    - `invoiceNumber` string, nullable: Stripe invoice number, when available.
    - `reversedCredits` number, required: Cumulative credits removed by append-only payment_reversal entries; never exceeds credits.
    - `paidAt` string, date-time, nullable
    - `refundedAt` string, date-time, nullable
    - `createdAt` string, date-time, 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)