# get()

Retrieves a specific [API key](https://clerk.com/docs/guides/development/machine-auth/api-keys.md) by its ID. Returns an [`APIKey`](https://clerk.com/docs/reference/backend/types/backend-api-key.md) object.

```ts
function get(apiKeyId: string): Promise<APIKeyResource>
```

## Parameters

| Name     | Type   | Description                        |
| -------- | ------ | ---------------------------------- |
| apiKeyId | string | The ID of the API key to retrieve. |

## Example

> Using `clerkClient` varies based on the SDK you're using. Refer to the [overview](https://clerk.com/docs/reference/backend/overview.md) for usage details, including guidance on [how to access the `userId` and other properties](https://clerk.com/docs/reference/backend/overview.md#example-get-the-user-id-and-other-properties).

```tsx
const apiKeyId = 'apikey_123'

const response = await clerkClient.apiKeys.get(apiKeyId)
```

## Backend API (BAPI) endpoint

This method in the SDK is a wrapper around the BAPI endpoint `GET/api_keys/{apiKeyId}`. See the [BAPI reference](https://clerk.com/docs/reference/backend-api/tag/api-keys/GET/api_keys/%7BapiKeyID%7D){{ target: '_blank' }} for more information.

---

## Sitemap

[Overview of all docs pages](https://clerk.com/docs/llms.txt)
