Management Keys

List API keys

Lists the API keys the caller may manage. With an organization Management Key, the response contains only keys belonging to that key's organization: it never includes the owner's personal keys or keys from another organization. A regular sk-bl- key cannot call this management endpoint; a logged-in session cookie is also supported by the web dashboard. Every keys[] item includes limit, limit_remaining, limit_reset, usage, usage_daily/weekly/monthly, requests, requests_daily/weekly/monthly, and usage_scope: key. These values match GET /v1/key when called with that key. When a per-key limit exists, limit_remaining is the limit minus spend in its reset period; without a per-key limit, it is the balance used by that key. Raw key secrets are never returned. For the worked example that first shows the organization total and then each key's usage, see the management-key example on the GET /v1/key page.

GET/v1/keys

Authorizations

Authorizationrequired

string · header

API key as bearer token in the Authorization header.

Query parameters

orgId

string

With a session cookie, optionally lists keys for an organization ID when the caller is that organization's org_admin or billing_viewer. An organization Management Key is restricted to its own organization and cannot switch organizations with this parameter.

GET /v1/keys

1
2
curl https://api.bazaarlink.ai/v1/keys \
  -H "Authorization: Bearer $BAZAARLINK_API_KEY"

Response examples

Success. keys[] is newest first and contains per-key metadata and usage, never the raw secret.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
{
  "keys": [
    {
      "id": "key_demo_01",
      "name": "worker-a",
      "keyPrefix": "demo_",
      "keySuffix": "01",
      "enabled": true,
      "keyType": "standard",
      "requestCount": 73,
      "totalTokens": 48200,
      "lastUsed": "2026-09-30T02:14:00.000Z",
      "createdAt": "2026-09-01T00:00:00.000Z",
      "spendLimitUsd": 10,
      "spendLimitPeriod": "day",
      "limit": 10,
      "limit_remaining": 7.88,
      "limit_reset": "day",
      "usage": 24.41,
      "usage_daily": 2.12,
      "usage_weekly": 5.64,
      "usage_monthly": 9.37,
      "requests": 314,
      "requests_daily": 18,
      "requests_weekly": 61,
      "requests_monthly": 205,
      "usage_scope": "key",
      "allowedModels": null,
      "expiresAt": null,
      "organizationId": "org_demo_01",
      "teamId": null,
      "orgMemberId": null
    }
  ]
}