Skip to content

Every Plune AI credit grant of the project’s plan owner, with what each draft spent

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

#1427 (frame 05, Settings → AI). Each grant with its amount, used, left, valid-until and whether it has expired; and the drafts paid from them, a failed or aborted one shown as refunded. A company’s credits are pooled over its projects: a draft of another project shows its credits and state, never its case. An owner or a member reads it; a reader gets 403.

The history

Media type application/json

#1427 (frame 05): every grant of the plan’s owner, newest first (up to 100), and the drafts that spent them (up to 1 000, newest first).

object
subject
required
object
kind
required
string
Allowed values: user company
id
required
string
grants
required
Array<object>
object
id
required
string
reason
required
string
Allowed values: signup month pack manual
amount
required
integer
used
required

The credits of its drafts in any state but failed or aborted (one still running holds its credit).

integer
left
required

amount less used.

integer
validFrom
required
string format: date-time
validUntil
required
string format: date-time
nullable
expired
required

Past its end (a month’s: no longer usable), so what is left of it cannot be spent.

boolean
provider
required

pack: the provider it was paid through; else null.

string
nullable
Allowed values: paddle monopay liqpay
tier
required

month: the plan that paid for it; else null.

string
nullable
Allowed values: free personal team enterprise
seats
required

month: the paid seats it was granted for (Free and Personal: 1); else null.

integer
nullable
note
required

manual: the operator’s words on it; else null. Who granted it is not shown here.

string
nullable
calls
required
Array<object>
object
id
required
string
grantId
required
string
at
required
string format: date-time
credits
required
integer
state
required
string
Allowed values: in_progress awaiting_decision accepted rejected expired failed aborted
refunded
required

failed or aborted: its credits came back.

boolean
projectId
required

Only for a draft of this project; a draft of another project of the plan shows null.

string
nullable
projectName
required

The draft’s project, for this project and for another of the plan the caller is a member of; else null.

string
nullable
testCaseId
required

As projectId.

string
nullable
Example
{
"subject": {
"kind": "user",
"id": "u-owner1"
},
"grants": [
{
"id": "g-1",
"reason": "pack",
"amount": 1000,
"used": 2,
"left": 998,
"validFrom": "2026-09-16T09:12:04.151Z",
"validUntil": "2027-09-16T09:12:04.151Z",
"expired": false
}
],
"calls": [
{
"id": "call-2",
"grantId": "g-1",
"at": "2026-09-16T09:12:04.151Z",
"credits": 1,
"state": "failed",
"refunded": true,
"projectId": "p-1",
"testCaseId": "tc-1"
},
{
"id": "call-1",
"grantId": "g-1",
"at": "2026-09-16T09:12:04.151Z",
"credits": 2,
"state": "accepted",
"refunded": false,
"projectId": null,
"testCaseId": 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"
}