Get the recovery allowances

curl https://api.subscriby.net/v1/recovery/allowances \  -H "Authorization: Bearer $SUBSCRIBY_TOKEN"

One row per kind, plus the window they are counted in.

self_service_remaining is what the rolling window still allows on its own; grant_remaining is what support has released on top and not yet spent. remaining is their sum and allowed whether a recovery of that kind would start right now.
uses_grant is true when the next recovery would spend a support grant rather than the self-service allowance.
next_self_service_at is when the self-service allowance returns, null while it is available. last_used_at is when the kind was last recovered inside the window.

See Allowances and support review for the rule and what support audits before releasing a grant.

Requires ability

project-recovery:view-any

The token must hold this ability, or the call is refused with 403.

MCP tool

get_recovery_allowances

Runs the same action from an agent, behind the same ability.

Authorization

bearerToken

AuthorizationBearer <token>

A personal access token minted on the dashboard under Settings, then Tokens, sent as Authorization: Bearer sbt_live_…. The token carries the abilities each endpoint lists under Requires ability and is frozen to one team.

In: header

Responses

200OKapplication/json

Array of RecoveryAllowanceResource

data*array<>

The items.

meta*

The rule the allowances are counted under.

401UnauthorizedAUTHENTICATION_REQUIREDapplication/json

The request carries no bearer token, or one that is revoked, malformed, or minted for another environment (an sbt_test_ token on production).

error*

The one envelope every failure uses.

403ForbiddenTOKEN_MISSING_ABILITYapplication/json

The token is valid but does not carry the ability this endpoint requires; error.context.required_ability names the one to grant. An endpoint that also checks who owns a row or which tier the account is on answers FORBIDDEN, TEAM_TIER_REQUIRED or CONNECTOR_TIER_REQUIRED with the same status, and says so in its own description.

error*

The one envelope every failure uses.

429Too many requestsRATE_LIMITEDapplication/json

The token has spent its 300 requests a minute or 10,000 an hour; Retry-After says when the next one is accepted.

error*

The one envelope every failure uses.

Call it from your code

A sample request in your language, the body each status answers with, and the types to hold them.

curl -X GET "https://example.com/v1/recovery/allowances"

{  "data": [    {      "kind": "account",      "kind_label": "Telegram Account",      "self_service_remaining": 1,      "grant_remaining": 0,      "remaining": 1,      "allowed": true,      "uses_grant": false,      "last_used_at": null,      "next_self_service_at": null    },    {      "kind": "bot",      "kind_label": "Project Bot",      "self_service_remaining": 1,      "grant_remaining": 0,      "remaining": 1,      "allowed": true,      "uses_grant": false,      "last_used_at": null,      "next_self_service_at": null    },    {      "kind": "resources",      "kind_label": "Channels and Groups",      "self_service_remaining": 0,      "grant_remaining": 1,      "remaining": 1,      "allowed": true,      "uses_grant": true,      "last_used_at": "2026-09-12T03:19:10Z",      "next_self_service_at": "2026-12-11T03:19:10Z"    }  ],  "meta": {    "window_days": 90,    "self_service_uses": 1  }}

Type definitions

The shapes above as types, ready to paste into your client.

export interface Response {  data: RecoveryAllowanceResource[];  meta: Meta;}export interface RecoveryAllowanceResource {  kind: string;  kind_label: string;  self_service_remaining: number;  grant_remaining: number;  remaining: number;  allowed: boolean;  uses_grant: boolean;  last_used_at: string | null;  next_self_service_at: string | null;}export interface Meta {  window_days: number;  self_service_uses: number;}

Get the recovery allowances

AuthorizationCopy Anchor Link

ResponsesCopy Anchor Link

Authorization

Responses