Skip to content

List all API keys for the authenticated user's account

GET
/keys

Successful response

Response body for GET /keys endpoint Lists all API keys for the authenticated account

object
keys
required

Array of API key metadata (does not include the actual key strings)

Array<object>
object
id
required

Unique identifier for the key (jti)

string
key
required

The full key string with prefix (shown for reference but should be stored securely by user)

string
keyType
required

Type of API key

string
Allowed values: secret public
environmentId

Environment ID if the key is scoped to a specific environment

string
accountId
required

The account ID that owns this key

string
name
required

Human-readable name/description for the key

string
revoked
required

Whether the key has been revoked

boolean
createdAt
required

ISO 8601 timestamp when the key was created

string
lastUsedAt

ISO 8601 timestamp of when the key was last used (if tracked)

string

Bad Request - validation errors, invalid input

Standard error response for API errors.

object
trackingId
required

Unique tracking ID for the request.

string
error
required

Structured error details for API error responses.

object
code
required

Machine-readable error code.

string
message
required

Human-readable error message.

string
fix

Actionable hint for fixing the error.

string
provider

Provider that caused the error (e.g. telnyx, ses).

string
providerCode

Provider-specific error code.

string

Unauthorized

Payment Required - usage limits exceeded

Standard error response for API errors.

object
trackingId
required

Unique tracking ID for the request.

string
error
required

Structured error details for API error responses.

object
code
required

Machine-readable error code.

string
message
required

Human-readable error message.

string
fix

Actionable hint for fixing the error.

string
provider

Provider that caused the error (e.g. telnyx, ses).

string
providerCode

Provider-specific error code.

string

Internal Server Error

Bad Gateway - provider error

Standard error response for API errors.

object
trackingId
required

Unique tracking ID for the request.

string
error
required

Structured error details for API error responses.

object
code
required

Machine-readable error code.

string
message
required

Human-readable error message.

string
fix

Actionable hint for fixing the error.

string
provider

Provider that caused the error (e.g. telnyx, ses).

string
providerCode

Provider-specific error code.

string