API keys

List API keys

List API keys for an owner with the Python SDK.

GET/api-keys

Use blnk.api_keys.list to list API keys for an owner.

Call the method

response = blnk.api_keys.list({
  "owner": "merchant_a",
})

Field	Type	Description
`owner`	`str`	Owner whose keys to return. Required when authenticating with the master key.

Use the key list

Iterate over response.data to find keys by name, scopes, or expiration. Plaintext key values are not included in list results.

Response

[
  {
    "api_key_id": "key_abc123def456",
    "name": "Service Account",
    "owner_id": "owner_id",
    "scopes": ["ledgers:read", "balances:write"],
    "expires_at": "2026-03-11T00:00:00Z",
    "created_at": "2024-01-15T10:30:00Z",
    "last_used_at": "2024-01-20T14:30:00Z"
  }
]

Field	Type	Description
`response.data`	`list[dict]`	Array of API key records without the plaintext key value.