---
title: "List API keys"
slug: "list-api-keys"
updated: 2025-07-13T08:17:27Z
published: 2025-07-13T08:17:27Z
canonical: "torq.io/list-api-keys"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://torq.io/llms.txt
> Use this file to discover all available pages before exploring further.

# List API keys

Get/v1alpha/api-keys

Returns a list of all API keys for the current workspace.

SecurityHTTPType bearer

Responses200

The list of API keys was retrieved successfully.

<select class='api-response-data' aria-label='Media type'><option value='172e105f-d0c4-40b0-8b23-f974e3a337fc'>application/json</option>
</select>Expand Allobject  api_keys Array of object (v1alphaApiKey)   

The list of API keys returned.

object  client_idstring    

The client ID of the API key.

Example74e19393-3e94-48d2-8b60-26f2d2665942
namestring    

The name of the API key.

typestring    

- API_KEY_TYPE_UNSPECIFIED: The type of the API key is unknown.
- API_KEY_TYPE_SERVICE: The API key is a service API key, meaning it is not associated with a specific user.
- API_KEY_TYPE_PRIVATE: The API key is a private API key.

Valid values[
  "API_KEY_TYPE_UNSPECIFIED",
  "API_KEY_TYPE_SERVICE",
  "API_KEY_TYPE_PRIVATE"
]Default"API_KEY_TYPE_UNSPECIFIED"
role_idstring  (uuid)    

The ID of the role associated with the API key.

Example74e19393-3e94-48d2-8b60-26f2d2665942
role_namestring    

The role associated with the API key.

created_timestring  (date-time)    

The timestamp when the API key was created.

Example2022-03-09T08:40:18.490Z
last_authenticated_timestring  (date-time)    

The timestamp when the API key was last used to generate an access token.

Example2022-03-09T08:40:18.490Z
userobject (usersv1alphaUser)  

The user object.

idstring  (uuid)    

The unique identifier of the user.

Example74e19393-3e94-48d2-8b60-26f2d2665942
emailstring  (email)    

The email address of the user.

Exampleuser@email.com
role_idstring  (uuid)    

The unique identifier of the role assigned to the user.

Example74e19393-3e94-48d2-8b60-26f2d2665942
statusstring    

- STATUS_UNSPECIFIED: Default value. This value is unused.
- INVITATION_SENT: Invitation email has been sent.
- VERIFIED: Membership verified.

Valid values[
  "STATUS_UNSPECIFIED",
  "INVITATION_SENT",
  "VERIFIED"
]Default"STATUS_UNSPECIFIED"
sso_provisionboolean    

If `true`, the user was provisioned in Torq with the SSO IdP.

Exampletrue
created_timestring  (date-time)    

The timestamp when the user was created.

Example2022-03-09T08:40:18.490Z
last_login_timestring  (date-time)    

When the user last logged on or used the API.

The timestamp when the user last logged in to Torq via the UI or the API.

Example2022-03-09T08:40:18.490Z

expires_atstring  (date-time)    

The timestamp when the API key expires.

Example2022-03-09T08:40:18.490Z

401

Invalid bearer token. If you receive this message more than once try creating a new Client ID/Client Secret or generating a new bearer token.

<select class='api-response-data' aria-label='Media type'><option value='e05d75e0-47c1-4e00-8c19-e301fc285174'>application/json</option>
</select>object  

403

You don't have permission to access this resource.

<select class='api-response-data' aria-label='Media type'><option value='6b9ba77e-761c-4493-aed3-ac64599ba52c'>application/json</option>
</select>object