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

# Obter detalhes da chave de API

> Este endpoint retorna os detalhes de uma chave de API específica.

## GET /api-keys/{keyId}

Este endpoint retorna informações detalhadas de uma única chave de API. Por segurança, o valor completo da chave nunca é retornado.

### Parâmetros de caminho

<ParamField path="keyId" type="string" required>
  ID da chave de API a ser consultada.
</ParamField>

### Resposta

<ResponseField name="id" type="string">
  Identificador único da chave.
</ResponseField>

<ResponseField name="name" type="string">
  Nome definido pelo usuário para a chave.
</ResponseField>

<ResponseField name="keyPreview" type="string">
  Prévia mascarada da chave (ex.: `llm_1234...abcd`).
</ResponseField>

<ResponseField name="isActive" type="boolean">
  Se a chave está ativa e pode ser usada.
</ResponseField>

<ResponseField name="lastUsedAt" type="string">
  Data e hora do último uso em ISO 8601.
</ResponseField>

<ResponseField name="createdAt" type="string">
  Data de criação em ISO 8601.
</ResponseField>

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET https://api.llmgenerator.com/api/v1/api-keys/llm_1706123456_abc123def456 \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```

  ```javascript Node.js theme={null}
  const response = await fetch(
    'https://api.llmgenerator.com/api/v1/api-keys/llm_1706123456_abc123def456',
    {
      headers: { 'Authorization': 'Bearer YOUR_API_KEY' }
    }
  );

  const key = await response.json();
  ```
</RequestExample>

<ResponseExample>
  ```json Sucesso (200) theme={null}
  {
    "id": "llm_1706123456_abc123def456",
    "name": "Production Key",
    "keyPreview": "llm_1706...f456",
    "description": null,
    "permissions": [],
    "isActive": true,
    "lastUsedAt": "2026-01-20T15:30:00.000Z",
    "expiresAt": null,
    "createdAt": "2026-01-01T10:00:00.000Z"
  }
  ```

  ```json Não encontrado (404) theme={null}
  {
    "message": "API key not found"
  }
  ```

  ```json Proibido (403) theme={null}
  {
    "message": "Access denied to this API key"
  }
  ```
</ResponseExample>