Fetch the current token

Fetch the API token making the request, the limits of the plan it belongs to, and your usage so far this month. An application or agent can use this to find out what it is allowed to do and how much of its allowance is left, all in one request.

Any active API token can call this endpoint, whatever its permissions.

GET https://api.jsonpad.io/tokens/self

Example

123

curl https://api.jsonpad.io/tokens/self \
  -H "Content-Type: application/json" \
  -H "x-api-token: <YOUR TOKEN>"

Parameters

No parameters

Request headers

required
x-api-tokenstringYour API token.

Request body

No request body

Response body

200 OK

{token: {id: "2225bfa7-c4cd-4d62-b082-6a5dd8f0f62b"
createdAt: "2026-09-11T16:56:03.634Z"
updatedAt: "2026-09-11T16:56:03.634Z"
name: "Sample Token"
permissions: [0: {mode: "allow"
action: "*"
}
]
ips: null
expiresAt: null
activated: true
description: "Sample token description"
locked: false
}
plan: {id: "free"
name: "Free Plan"
rateLimit: 100
maxRequestsPerMinute: 60
maxRequestsPerMonth: 25000
overdraftPercent: 0
maxStorageBytes: 104857600
maxLists: null
maxItemsPerList: null
maxIndexesPerList: null
maxItemSize: 102400
maxItemVersions: 10
maxTokens: 5
maxIdentities: 100
maxRealtimeConnections: 1
generativeAPI: true
}
usage: {periodStart: "2026-09-01T00:00:00.000Z"
periodEnd: "2026-10-01T00:00:00.000Z"
requestCount: 6658
blockedCount: 0
requestAllowance: 25000
requestsRemaining: 18342
overdraftAllowance: 0
credits: 0
storageBytes: 1048576
storageAllowance: 104857600
degraded: false
}
}

tokenobjectThe token making the request. The token value itself is not included.
planobject
The limits in effect for this request. A null limit means there is no limit, and rateLimit is the minimum gap between requests in milliseconds.
If usage.degraded is true, then rateLimit and maxRequestsPerMinute are the free tier's rather than your plan's.
usageobject
Usage for the current calendar month, across your whole account rather than just this token. requestsRemaining includes any overdraft and prepaid credits, and is null if your plan has no monthly limit.
degraded is true once your allowance and credits have run out, and reads are being served at the free tier's rate limit. See what happens when you run out.

Response headers

Like any request made with an API token, this one counts against your monthly allowance, and its response carries the rate limit and quota headers described in limits and quotas.

2026-09-11