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

# Consultar cobrança

> Consulte uma cobrança PIX pelo UUID público.

Consulta uma cobrança da loja vinculada ao token. Requer `pix:read`.

<ParamField path="id" type="string" required>
  UUID público da cobrança.
</ParamField>

<ResponseExample>
  ```json theme={null}
  {
    "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
    "store": { "id": "uuid-da-loja", "name": "Padrão" },
    "status": "paid",
    "amount": 19.9,
    "currency": "BRL",
    "qrcode": "data:image/png;base64,...",
    "copy_paste": "000201...",
    "customer": { "email": "cliente@loja.com", "name": "Ana Silva", "document": "39053344705" },
    "metadata": { "order_id": "1001" },
    "notification_url": "https://loja.com/webhooks/agitapay",
    "paid_at": "2026-09-02T14:30:00Z"
  }
  ```
</ResponseExample>

Um UUID inexistente ou pertencente a outra loja retorna `404 not_found`.