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

# QR Code

> Obtém QR Code atual da sessão

Retorna o QR Code atual da sessão se ela estiver em estado de aguardando escaneamento. Útil para obter um QR Code atualizado sem reiniciar a conexão.

## Path Parameters

<ParamField path="id" type="string" required>
  ID da sessão (UUID).
</ParamField>

## Query Parameters

<ParamField query="format" default="base64" type="string">
  Formato do QR Code.

  **Valores:**

  * `base64` - Imagem PNG em base64
  * `raw` - String do QR Code
  * `image` - Retorna imagem PNG diretamente
</ParamField>

## Resposta

<ResponseField name="qrCode" type="string">
  QR Code em formato texto.
</ResponseField>

<ResponseField name="qrCodeImage" type="string">
  QR Code como imagem base64 PNG.
</ResponseField>

<ResponseField name="expiresAt" type="string">
  Timestamp de quando o QR Code expira.
</ResponseField>

<RequestExample>
  ```bash cURL theme={"system"}
  curl -X GET "https://api.oxenty.api.br/api/sessions/550e8400-e29b-41d4-a716-446655440000/qrcode?format=base64" \
    -H "X-API-Key: YOUR_API_KEY"
  ```

  ```typescript TypeScript theme={"system"}
  const qr = await client.sessions.getQrCode('550e8400-e29b-41d4-a716-446655440000');
  console.log('QR Code:', qr.qrCodeImage);
  ```

  ```python Python theme={"system"}
  qr = client.sessions.get_qr_code('550e8400-e29b-41d4-a716-446655440000')
  print(f"QR Code: {qr['qrCodeImage']}")
  ```
</RequestExample>

<ResponseExample>
  ```json 200 OK theme={"system"}
  {
    "qrCode": "2@ABC123xyz...",
    "qrCodeImage": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAA...",
    "expiresAt": "2024-01-15T10:01:00.000Z"
  }
  ```

  ```json 400 Bad Request theme={"system"}
  {
    "statusCode": 400,
    "error": "SESSION_NOT_IN_QR_STATE",
    "message": "Sessão não está aguardando escaneamento de QR Code"
  }
  ```

  ```json 404 Not Found theme={"system"}
  {
    "statusCode": 404,
    "error": "SESSION_NOT_FOUND",
    "message": "Sessão não encontrada"
  }
  ```
</ResponseExample>

<Warning>
  Este endpoint só retorna QR Code se a sessão estiver em estado `qr`. Se a sessão estiver `disconnected`, você precisa chamar `/connect` primeiro.
</Warning>