Skip to content

The Plune AI credits of the owner of the project’s plan, grant by grant

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

#1427. The balance belongs to the owner of the plan (tierOf): the account on Free and Personal, the company on Team and Enterprise. Free gets 10 once, at the first sign-in (one grant an address: lowercased, trimmed, the +suffix before @ dropped); Personal 50 a month, Team 50 and Enterprise 100 a month a paid seat, pooled, from the day the plan was paid, with nothing carried over. Only the grants usable now are listed: what is left of the last paid month stays usable up to 14 days after it ends (a renewal not paid yet, the grace period) until the next month starts, and not at all once the plan is Free. left is a grant’s amount less the credits of its drafts, a failed or aborted draft giving its credit back. An owner or a member reads it; a reader gets 403.

The credits, granted and left summed over grants

Media type application/json

#1427: the Plune AI credits of the owner of a project’s plan, grant by grant.

object
subject
required
object
kind
required
string
Allowed values: user company
id
required
string
tier
required

The plan of subject.

string
Allowed values: free personal team enterprise
granted
required

The sum of amount over grants.

integer
left
required

The sum of left over grants.

integer
grants
required
Array<object>
object
id
required
string
reason
required
string
Allowed values: signup month pack manual
amount
required
integer
left
required
integer
validFrom
required
string format: date-time
validUntil
required

null: no end (the signup grant).

string format: date-time
nullable
Example
{
"subject": {
"kind": "user",
"id": "u-owner1"
},
"granted": 10,
"left": 7,
"grants": [
{
"id": "g-1",
"reason": "signup",
"amount": 10,
"left": 7,
"validFrom": "2026-09-16T09:12:04.151Z",
"validUntil": null
}
]
}

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"
}