Get pending earnings breakdown

GET

/payouts/earnings/pending-breakdown

Per-donation attribution of the creator's not-yet-available money, lazy-loaded by the Earnings tab's Pending-tile dialog (#1131). Ledger-only — a single SQL query, zero Stripe round-trips. The target is always the authenticated principal. Each donation is classified into one of three states that mirror the admin grid's evidence model: destination_charge_pending (Stripe holds it for this creator, card settlement pending), platform_held_unsettled (platform balance, awaiting settlement), or platform_held_settled (platform balance, eligible for release now). Rows already transferred to the creator's Stripe balance, settled destination charges, and anomaly rows are excluded. Rate limited per authenticated user.

Authorizations

BearerAuth

Authentication is handled automatically via httpOnly session cookies after signing in at /cognito/signin or via Google SSO at /cognito/oauth/google. For Swagger UI testing, paste a JWT token from the /cognito/signin response.

Type

HTTP (bearer)

Responses

Pending breakdown (all amounts in cents)

Content-Type

application/json

{

"pending_breakdown": {

"total_cents": 0,

"destination_charge_cents": 0,

"platform_held_unsettled_cents": 0,

"platform_held_settled_cents": 0,

"donations": [

{

"donation_id": "string",

"amount_cents": 0,

"fundraiser_title": "string",

"fundraiser_slug": "string",

"state": "string",

"available_on": "string",

"donated_at": "string"

}

]

}

}

GET

/payouts/earnings/pending-breakdown

Playground

Server

Authorization

BearerAuth

Samples

Powered by VitePress OpenAPI