Skip to content

List API keys for the caller's org

GET
/v1/settings/api-keys
curl --request GET \
--url https://dev-api.infiniteaudience.ai/v1/settings/api-keys \
--header 'Authorization: Bearer <token>'

Returns all API keys for the caller’s org, ordered by creation date descending. Key values are never included in list responses. Requires ‘account’ scope.

List of API keys.

Media typeapplication/json
object
keys
Array<object>
object
id
string
name
string
scopes
Array<string>
active
boolean
created_at
string format: date-time
last_used
string | null format: date-time
Examplegenerated
{
"keys": [
{
"id": "example",
"name": "example",
"scopes": [
"example"
],
"active": true,
"created_at": "2026-04-15T12:00:00Z",
"last_used": "2026-04-15T12:00:00Z"
}
]
}

Missing or invalid Bearer token. Obtain one via POST /v1/auth/token. When a token was supplied but rejected, code distinguishes TOKEN_EXPIRED (the token’s lifetime has passed — request a new one via POST /v1/auth/token and retry) from TOKEN_INVALID (malformed or revoked — re-authenticate).

Media typeapplication/json
object
error
required

Stable machine-readable error code (e.g. INVALID_STATUS_TRANSITION, BILLING_INSUFFICIENT_BALANCE). Always present.

string
message

Human-readable explanation of the error.

string
code

Alternate machine-readable code — present on some endpoints as an alias for error for backward compatibility.

string
request_id

Opaque support/debug identifier when available.

string
key
additional properties
any
Examples
{
"error": "Unauthorized: Missing or invalid Authorization header"
}

Token is valid but lacks the required scope for this endpoint. Check the endpoint description for the required scope (discovery, purchase, or account).

Media typeapplication/json
object
error
required

Stable machine-readable error code (e.g. INVALID_STATUS_TRANSITION, BILLING_INSUFFICIENT_BALANCE). Always present.

string
message

Human-readable explanation of the error.

string
code

Alternate machine-readable code — present on some endpoints as an alias for error for backward compatibility.

string
request_id

Opaque support/debug identifier when available.

string
key
additional properties
any
Examples
Examplemissing_scope
{
"error": "SCOPE_REQUIRED",
"message": "This endpoint requires the purchase scope."
}