Skip to content

The newest pack overage bought, or null

GET
/v1/settings/ai/credits/overage/notice
curl --request GET \
--url https://beta-api.plune.ai/v1/settings/ai/credits/overage/notice \
--header 'Authorization: Bearer <token>'

#1427 (D12, frame 10): what Settings → AI shows after an automatic purchase — pending (being charged, or a Monopay invoice to pay at payUrl), paid, or failed (nothing charged). An owner or a member reads it; a reader gets 403.

The notice

Media type application/json
object
notice
required
object
id
required
string
provider
required
string
Allowed values: paddle monopay liqpay
status
required

pending: asked of the provider, not paid yet; paid: its credits granted; failed: nothing was charged.

string
Allowed values: pending paid failed
auto
required

Bought by overage (D12), not by a click.

boolean
credits
required
integer
usdCents
required
integer
uahKopiyky
required

What Monopay or LiqPay charges, in kopiyky: $80 × monobank’s selling rate of that day (D9). null for Paddle, or before the amount is fixed.

integer
nullable
payUrl
required

The page to pay it on while it is pending and its link lives (24 hours) — a checkout, or a Monopay overage invoice; else null.

string
nullable
createdAt
required
string format: date-time
paidAt
required
string format: date-time
nullable
validUntil
required

12 months from paidAt; null until paid.

string format: date-time
nullable
Example
{
"notice": {
"id": "pack-1",
"provider": "monopay",
"status": "paid",
"auto": true,
"credits": 1000,
"usdCents": 8000,
"uahKopiyky": 331000,
"payUrl": null,
"createdAt": "2026-09-16T09:12:04.151Z",
"paidAt": "2026-09-16T09:12:04.151Z",
"validUntil": "2027-09-16T09:12:04.151Z"
}
}

No / invalid token or session

A reader asked

Media type application/json
object
error
required
string
Example
{
"error": "AI settings are not visible to a reader"
}

Rate-limited: the per-route throttle, or the per-minute request limit of the plan an API token counts by (#1442; the body names the plan, #2092). Retry-After carries the seconds until the window rolls over.

Media type application/json
object
error
required
string
Example generated
{
"error": "example"
}
Retry-After
integer

Seconds until the window rolls over

This server keeps no credits ledger

Media type application/json
object
error
required
string
Example
{
"error": "AI platform not configured — contact your operator"
}