---
title: "List persistent billing notices"
method: GET
path: "/v1/billing/notices"
---

# List persistent billing notices

`GET /v1/billing/notices`

## Request

- Base URL: `https://docs.greatwait.dev` (the document declares no server; this is the origin it was published from)
- URL: `https://docs.greatwait.dev/v1/billing/notices`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `Greatwait-Environment` and API key in header `Greatwait-Project`

Lists the verified organization's durable billing notices with exact USD amounts, affected scope, payment state, a fixed same-page recovery path, and visible email delivery failure. Raw provider details, payment credentials, callback data and arbitrary URLs have no field.

## Query parameters

- `cursor` string
- `limit` integer

## Response `200`

List persistent billing notices

- object
  - `data` object[], required
    - `amounts` object, required
      - `available` object
        - `currency` 'USD', required
        - `microdollars` string, required
        - `scale` 6, required
      - `gross` object
        - `currency` 'USD', required
        - `microdollars` string, required
        - `scale` 6, required
      - `limit` object
        - `currency` 'USD', required
        - `microdollars` string, required
        - `scale` 6, required
      - `threshold` object
        - `currency` 'USD', required
        - `microdollars` string, required
        - `scale` 6, required
    - `detail` string, required
    - `email` object, required
      - `attempts` integer, required
      - `failureCode` string
      - `lastAttemptAt` string, nullable, required
      - `state` 'pending' | 'delivered' | 'failed' | 'suppressed', required
    - `id` string, required
    - `kind` 'budget-warning' | 'budget-exhausted' | 'low-credit' | 'automatic-top-up-cap-reached' | 'funding-blocked' | 'payment-pending' | 'payment-succeeded' | 'payment-failed' | 'payment-authentication-required' | 'payment-outcome-unresolved' | 'service-restored' | 'schedule-auto-paused' | 'delivery-failed', required
    - `occurredAt` string, required
    - `payment` object, nullable, required
      - `operation` string, required
      - `state` 'pending' | 'paid' | 'failed' | 'authentication-required' | 'action-required' | 'canceled' | 'refunded' | 'reversed' | 'disputed', required
    - `recoveryPath` union, required
      - '#billing' | '#billing-funding' | '#billing-notification-settings'
      - string
    - `resolvedAt` string, nullable, required
    - `scope` union, required
      - object
        - `kind` 'organization', required
      - object
        - `kind` 'project', required
        - `project` string, required
    - `severity` 'warning' | 'critical' | 'recovery', required
    - `state` 'active' | 'resolved', required
    - `title` string, required
    - `updatedAt` string, required
  - `freshness` object, required
    - `kind` 'authoritative', required
  - `nextCursor` string

## Other responses

- `400`: Problem document. Possible codes at this status: invalid_request.
- `401`: Problem document. Possible codes at this status: authentication_required, credential_expired, credential_revoked.
- `403`: Problem document. Possible codes at this status: scope_missing.
- `409`: Problem document. Possible codes at this status: project_archived.
- `429`: Problem document. Possible codes at this status: rate_limited.
- `503`: Problem document. Possible codes at this status: capability_not_configured, service_unavailable.

---

[API](https://skmtc.dev/greatwait/apis/greatwait-v1.md) · [All operations](https://skmtc.dev/greatwait/apis/greatwait-v1/llms.txt) · [OpenAPI document](https://skmtc.dev/greatwait/apis/greatwait-v1/revisions/6855bce23e72?raw)