Skip to content

A subject’s Plune AI credits, grant by grant

GET
/v1/admin/credits
curl --request GET \
--url 'https://beta-api.plune.ai/v1/admin/credits?subject=company%3A6f1c2b3a-0000-4000-8000-0000000000a5' \
--cookie plune_session=<plune_session>

#1427 D15 (frame 07): every grant of one account or company, newest first (up to 100), with used, left, its source, note and who granted it; granted and left sum the grants usable now. Owner-only, as GET /v1/admin/tier-grants (an admin token with the tier-grants door too); everyone else gets 404. Ten calls a minute.

subject
required
string
Example
company:6f1c2b3a-0000-4000-8000-0000000000a5

user:<id> or company:<id>

The credits

Media type application/json
object
subject
required
object
kind
string
id
string
granted
required
integer
left
required
integer
grants
required
Array<object>

#1427 D15: a grant as the admin sees it — with where it came from, the operator’s note and who granted it.

object
id
required
string
reason
required
string
Allowed values: signup month pack manual
amount
required
integer
used
required
integer
left
required
integer
validFrom
required
string format: date-time
validUntil
required
string format: date-time
nullable
expired
required
boolean
sourceRef
required

The payment or paid plan it came from (payment monopay <invoice>, tier_grant <id>).

string
nullable
note
required

The operator’s words on a grant by hand.

string
nullable
grantedBy
required
string
nullable
createdAt
required
string format: date-time
provider
required

pack: the provider it was paid through.

string
nullable
Allowed values: paddle monopay liqpay
tier
required

month: the plan that paid for it.

string
nullable
Allowed values: free personal team enterprise
seats
required

month: its paid seats (Free and Personal: 1).

integer
nullable
grantedByEmail
required

The address of whoever granted it by hand.

string
nullable
Example
{
"subject": {
"kind": "company",
"id": "6f1c2b3a-0000-4000-8000-0000000000a5"
},
"granted": 150,
"left": 120,
"grants": [
{
"id": "g-1",
"reason": "month",
"amount": 150,
"used": 30,
"left": 120,
"validFrom": "2026-09-16T09:12:04.151Z",
"validUntil": "2026-10-16T09:12:04.151Z",
"expired": false,
"sourceRef": "tier_grant tg-1",
"note": null,
"grantedBy": null,
"createdAt": "2026-09-16T09:12:04.151Z"
}
]
}

subject is not user:<id> or company:<id>

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

No / invalid session

The caller does not own the application — or there is no such account or company

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

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