---
title: "PAYG add-on credit-pack purchase history"
method: GET
path: "/api/me/billing/payg-purchases"
tags: ["me"]
---

# PAYG add-on credit-pack purchase history

`GET /api/me/billing/payg-purchases`

## Request

- Base URL: `https://api.signalraven.ai`
- URL: `https://api.signalraven.ai/api/me/billing/payg-purchases`
- Auth: none declared

Admin-only. Sibling to /api/me/billing/invoices for the one-off add-on credit-pack flow. Admin-granted packs excluded. Includes refund status derived from credit_transactions.

## Query parameters

- `limit` string

## Response `200`

PAYG purchase list

- PaygPurchasesResponse
  - `purchases` PaygPurchase[], required
    - `id` string, uuid, required
    - `credits` integer, required: Credits granted at purchase (whole units).
    - `creditsRemaining` number, required: Credits still available from this pack (scale-4 since migration 0038). Zero when refunded or fully consumed.
    - `amountCents` integer, required: What the customer paid, in the smallest currency unit.
    - `currency` 'usd', required
    - `purchasedAt` string, date-time, required
    - `expiresAt` string, date-time, required
    - `planSlugAtPurchase` string, required: Customer's plan slug at purchase time — determined the $/credit rate charged.
    - `receiptUrl` string, uri, nullable, required: Stripe-hosted receipt URL. NULL for the one pre-migration test purchase; portal renders "—" in that case.
    - `isExpired` boolean, required: true when expires_at has passed. Server-derived so portal state stays consistent across timezones.
    - `isRefunded` boolean, required: true when a credit_transactions row with type=refund references this pack. Row still shown in history with a "(refunded)" tag.
  - `hasMore` boolean, required: true when more rows exist past `limit`. Portal renders a hint pointing to Stripe Customer Portal for full history.

## Other responses

- `401`: Not authenticated
- `403`: Not admin

---

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