This endpoint lists all API keys for the authenticated user. It returns information about each API key, including its name, description, creation date, and access permissions. The actual API key values are not returned for security reasons.
Request
This endpoint does not require any parameters.
Example Request
Response
Array of API key objects The description of the API key
A masked version of the API key for display purposes
The access permissions for the API key
The creation date of the API key (ISO 8601 format)
Total number of API keys for the user
Example Response
{
"listKeyResponse" : {
"keys" : [
{
"name" : "Production API Key" ,
"desc" : "Used for production server integration" ,
"api_key" : "brx_api_1234...abcdef" ,
"access_perms" : "read-only" ,
"createdAt" : "2023-01-01T00:00:00.000Z"
},
{
"name" : "Development API Key" ,
"desc" : "Used for development and testing" ,
"api_key" : "brx_api_5678...ghijkl" ,
"access_perms" : "read-write" ,
"createdAt" : "2023-01-02T00:00:00.000Z"
}
],
"total" : 2
}
}
Example Response (No API Keys)
{
"listKeyResponse" : {
"keys" : [],
"total" : 0
}
}
Error Codes
Unauthorized - Authentication credentials are missing or invalid
Internal Server Error - An unexpected error occurred on the server
Notes
This endpoint returns information about all API keys for the authenticated user.
The actual API key values are not returned for security reasons. Instead, a masked version of each API key is returned for display purposes.
The access_perms field indicates the access permissions for the API key, such as “read-only” or “read-write”.
To generate a new API key, use the Generate API Key endpoint.
To delete an API key, use the Delete API Key endpoint.