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

# GET /v1/apikeys: List PIN API Keys

> List all API keys belonging to the current PIN user. Returns metadata for each key; the full key value is not exposed after creation.

Use the list API keys endpoint to retrieve all API keys associated with the authenticated account. The response includes each key's id, name, prefix, and creation timestamp. The full key value is not returned.

## Endpoint

```http theme={null}
GET /v1/apikeys
```

## Authentication

Requires a valid `Authorization: Bearer <jwt-or-api-key>` header.

## Response

<ResponseField name="items" type="array">
  <Expandable title="API key object">
    <ResponseField name="id" type="string">
      Unique API key identifier.
    </ResponseField>

    <ResponseField name="name" type="string">
      Human-readable name for the key.
    </ResponseField>

    <ResponseField name="prefix" type="string">
      Visible prefix of the key for identification.
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp when the key was created.
    </ResponseField>
  </Expandable>
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://ariapin.example.com:8001/v1/apikeys \
    -H "Authorization: Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9..."
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "code": 0,
    "data": {
      "items": [
        {
          "id": "key_abc",
          "name": "production",
          "prefix": "prod_...",
          "created_at": "2024-01-15T09:30:00Z"
        }
      ]
    },
    "message": ""
  }
  ```
</ResponseExample>

Retrieve the API keys created by the current user. Each item includes a `key_preview` so you can distinguish keys without exposing the full secret. Only the plaintext key returned at creation time is usable for authentication.

## Endpoint

**GET** `/v1/apikeys`

Authentication: Bearer API key

## Response

<ResponseField name="items" type="array">
  List of API key objects scoped to the current user.

  <Expandable defaultOpen>
    <ResponseField name="id" type="string">
      Unique key identifier.
    </ResponseField>

    <ResponseField name="name" type="string">
      Human-readable name for the key.
    </ResponseField>

    <ResponseField name="key_preview" type="string">
      Masked preview of the key (e.g., `ak_****xyz1`).
    </ResponseField>

    <ResponseField name="created_at" type="string">
      ISO 8601 timestamp when the key was created.
    </ResponseField>
  </Expandable>
</ResponseField>

## Example

```bash theme={null}
curl -H "Authorization: Bearer $ARIA_PIN_KEY" \
  http://localhost:8001/v1/apikeys
```

```json theme={null}
{
  "items": [
    {
      "id": "key_7aBc3DeFgH4",
      "name": "default",
      "key_preview": "ak_****wxyz",
      "created_at": "2025-01-15T09:22:00Z"
    }
  ]
}
```


## Related topics

- [POST /v1/apikeys — Create PIN API Key](/api-reference/pin/apikeys/create.md)
- [List Agents - GET /v1/agents](/api-reference/agent/agents/list.md)
- [PIN Delete API Key](/api-reference/pin/apikeys/delete.md)
- [Authenticate with PIN API Keys and Agent Tokens](/api-reference/pin/authentication.md)
- [AGENT API Authentication: Bearer and ApiKey](/api-reference/agent/authentication.md)