Account
Check your plan, credit balance, rate limits, and usage programmatically.
GET
/v1/meFree — not meteredUse this for pre-flight checks before a batch job, low-balance monitoring/alerts, or to display credits in your own UI. It's authenticated by your API key and rate limited, but consumes no credits — so it keeps working even at a zero balance (unlike metered endpoints, which return 402 INSUFFICIENT_CREDITS).
Example request
curl "https://chainkit.ai/v1/me" \ -H "Authorization: Bearer thw_live_xxxxxxxx"
Example response
{
"organizationId": "ef92f8ff-ee77-4b58-9a52-7313aad91750",
"plan": "free",
"planName": "Free",
"credits": {
"balance": 9925,
"monthlyCredits": 10000,
"renewsAt": "2026-07-04T10:15:00.000Z"
},
"rateLimits": { "balances": 30, "gas": 60, "quotes": 10, "default": 60 },
"usage": { "requestsThisMonth": 5, "creditsThisMonth": 75 }
}Response fields
| Field | Type | Description |
|---|---|---|
| organizationId | string | Your organization id. |
| plan | string | Plan id: free, starter, growth, or scale. |
| planName | string | Human-readable plan name. |
| credits.balance | number | Current credit balance. |
| credits.monthlyCredits | number | Credits granted each month by your plan. |
| credits.renewsAt | string | null | ISO timestamp of the next monthly renewal. |
| rateLimits | object | Per-minute request limits by endpoint category. |
| usage.requestsThisMonth | number | Successful billed requests this month. |
| usage.creditsThisMonth | number | Credits consumed this month. |
Tip: every metered response also returns
X-Credits-Remaining, so you usually don't need to poll /v1/me on the hot path — reach for it for checks that shouldn't spend credits or run without traffic.