Skip to content
Plune Plune Plune Docs

The queue of requests for a paid tier

GET
/v1/admin/tier-requests
 
curl --request GET \
  --url 'https://beta-api.plune.ai/v1/admin/tier-requests?status=open' \
  --cookie plune_session=<plune_session>

The requests people made from the page of plans (#2121), of one status (open when left out), with who asked: the open ones oldest first, the closed ones last closed first, up to 200. A request is switched on with POST /v1/admin/tier-grants and then closed with PATCH /v1/admin/tier-requests/{id}. Owner-only and session-only, as GET /v1/admin/tiers (an admin token with the tier-grants door too); everyone else gets 404. Ten calls a minute.

Authorizations

Section titled “Authorizations ”

Parameters

Section titled “ Parameters ”

Query Parameters

Section titled “Query Parameters ”
status
string
default: open
Allowed values: open done declined

Responses

Section titled “ Responses ”

200

Section titled “200 ”

The requests of that status

Media type application/json
object
requests
required
Array

A row of the operator’s queue: the request and who asked.

object
id
required
string format: uuid
tier
required
string
Allowed values: personal team enterprise
subject
required
object
kind
required
string
Allowed values: user company
id
required
string
status
required
string
Allowed values: open done declined
createdAt
required
string format: date-time
requester
required
object
id
required
string
email
required
string format: email
name
required
string
nullable
Example 
{
  "requests": [
    {
      "id": "6f1c2b3a-0000-4000-8000-0000000000f6",
      "tier": "team",
      "subject": {
        "kind": "company",
        "id": "6f1c2b3a-0000-4000-8000-0000000000a5"
      },
      "status": "open",
      "createdAt": "2026-09-16T09:12:04.151Z",
      "requester": {
        "id": "u-shop",
        "email": "[email protected]",
        "name": "Olena Kovalenko"
      }
    }
  ]
}

400

Section titled “400 ”

A status that is not listed

Media type application/json
object
error
required
string
Example 
{
  "error": "status: must be one of open, done, declined"
}

401

Section titled “401 ”

No / invalid session

404

Section titled “404 ”

The caller does not own the application

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

429

Section titled “429 ”

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

Headers

Section titled “Headers ”
Retry-After
integer

Seconds until the window rolls over