Skip to Content
Organization

Get plan limits and usage

GET
/api/v1/limits

Returns the organization's plan, its quotas, what it used this billing month, and what remains: documents, eID signatures per scheme (signatures, keyed by a scheme such as SE_BANKID), members, the AI budget, identity checks, and workspaces. An unlimited quota is null. Money is { amount, currency } in minor units: balance is in the organization's currency, and the AI budget is in SEK. Use it to gate features, such as checking how many BankID signatures remain before you send.

Authorization

headerAuthorizationBearer <token>

API key, e.g. Authorization: Bearer sajn_svc_.... Not scope-limited: acts with its owner's workspace role.

Header Parameters

Sajn-Version?string

API version for this request. Without it, the request uses the organization's default version; an organization without a default is pinned to the latest version by its first request.

Value in"2026-09""2026-10"
Sajn-Workspace?string

ID of the workspace this request acts in, from GET /api/v1/workspaces. Without it, an API key acts in its default workspace. The token's user must be a member of the workspace; an OAuth token only accepts the workspace it was granted for. A workspace that doesn't exist or can't be reached returns 403 WORKSPACE_ACCESS_DENIED.

Response Body

200

application/json
  1. response
plan*string
balance*

Prepaid credit in the organization's currency. It pays for use beyond the plan, and is negative when that use is invoiced afterwards.

quota*
usage*
remaining*
subscription*
Example Request
curl -X GET 'https://app.sajn.se/api/v1/limits'
Example Response
{  "plan": "TEAM",  "balance": {    "amount": 0,    "currency": "SEK"  },  "quota": {    "signatures": {      "SE_BANKID": 100    },    "members": 10,    "aiBudget": {      "amount": 50000,      "currency": "SEK"    },    "identityChecks": 50,    "documents": 500,    "workspaces": 5,    "parties": 50  },  "usage": {    "signatures": {      "SE_BANKID": 12    },    "members": 4,    "sms": 3,    "aiSpent": {      "amount": 1250,      "currency": "SEK"    },    "aiSpentSigner": {      "amount": 300,      "currency": "SEK"    },    "identityChecks": 2,    "documents": 42,    "workspaces": 2  },  "remaining": {    "signatures": {      "SE_BANKID": 88    },    "members": 6,    "aiBudget": {      "amount": 48750,      "currency": "SEK"    },    "identityChecks": 48,    "documents": 458,    "workspaces": 3  },  "subscription": {    "isFreeTrial": false,    "periodEnd": "2026-10-31T23:59:59.000Z",    "cancelAtPeriodEnd": false  }}

Was this page helpful?