---
title: "List billing transactions"
method: GET
path: "/billing/transactions/"
tags: ["billing"]
---

# List billing transactions

`GET /billing/transactions/`

## Request

- Base URL: `https://api.getoneprofile.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.getoneprofile.ai/billing/transactions/`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

List the organization's Stripe invoices, newest first: subscription invoices and one-time credit pack invoices. Empty for organizations that never had a Stripe customer.

## Query parameters

- `limit` integer: Maximum number of invoices to return.
- `starting_after` string, nullable: Stripe invoice ID cursor for pagination.

## Response `200`

Successful Response

- TransactionsResponseSchema: Response schema for the organization's invoice history.
  - `invoices` InvoiceReadSchema[], required: The invoices, newest first.
    - `amount_due` integer, required: The amount due in cents.
    - `amount_paid` integer, required: The amount paid in cents.
    - `created` string, date-time, required: When the invoice was created.
    - `currency` string, required: The three-letter ISO currency code.
    - `hosted_invoice_url` string, nullable, required: URL of the hosted invoice page. None for draft invoices.
    - `id` string, required: The Stripe invoice ID.
    - `invoice_pdf` string, nullable, required: URL of the invoice PDF. None for draft invoices.
    - `number` string, nullable, required: The customer-facing invoice number. None until finalized.
    - `status` 'draft' | 'open' | 'paid' | 'uncollectible' | 'void', required: The invoice status.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden
- `422`: Invalid request made to the API.
- `500`: Internal server error.
- `502`: Bad gateway error.
- `503`: Service unavailable.

---

[API](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile.md) · [All operations](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/llms.txt) · [OpenAPI document](https://skmtc.dev/getoneprofile/apis/api-reference-oneprofile/revisions/4a6bd71e3f02?raw)