Skip to main content
GET
/
v1
/
keys
/
{key_id}
curl https://api.chowder.dev/v1/keys/key_9f8a7b6c \
  -H "Authorization: Bearer chd_sk_your_org_key"

{
  "id": "key_9f8a7b6c",
  "name": "Production Bot Key",
  "key_prefix": "chd_sk_",
  "is_active": true,
  "expires_at": "2026-12-31T23:59:59Z",
  "last_used_at": "2026-02-14T08:30:00Z",
  "created_at": "2026-02-14T12:00:00Z",
  "instances": [
    {
      "instance_id": "inst_abc123",
      "permissions": ["read", "interact", "channels"]
    },
    {
      "instance_id": "inst_def456",
      "permissions": ["read", "interact", "channels"]
    }
  ]
}
Look up a single API key by ID. This endpoint returns the full picture — key metadata plus which instances the key can access and with what permissions.

​
Authorization

Requires an organization-level API key in the Authorization header.

​
Path Parameters

​
key_id
string
required
The ID of the key to retrieve.

​
Response

​
id
string
Unique identifier for the key.
​
name
string
The human-readable name assigned at creation.
​
key_prefix
string
The key prefix (chd_sk_).
​
is_active
boolean
Whether the key is currently active.
​
expires_at
string | null
Expiration datetime, if one was set.
​
last_used_at
string | null
The last time this key was used to authenticate a request.
​
created_at
string
When the key was created.
​
instances
object[]
The instances this key has access to, along with the granted permissions.
curl https://api.chowder.dev/v1/keys/key_9f8a7b6c \
  -H "Authorization: Bearer chd_sk_your_org_key"

{
  "id": "key_9f8a7b6c",
  "name": "Production Bot Key",
  "key_prefix": "chd_sk_",
  "is_active": true,
  "expires_at": "2026-12-31T23:59:59Z",
  "last_used_at": "2026-02-14T08:30:00Z",
  "created_at": "2026-02-14T12:00:00Z",
  "instances": [
    {
      "instance_id": "inst_abc123",
      "permissions": ["read", "interact", "channels"]
    },
    {
      "instance_id": "inst_def456",
      "permissions": ["read", "interact", "channels"]
    }
  ]
}