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

# Listar logs do app

> Lista os disparos registrados de um app

Cada tentativa de envio a um provedor (Spedy, Utmify, Trackup) gera um log com a requisição e a resposta.

Permissão: `app.read` (chave secreta).

## Endpoint

<CodeGroup>
  ```bash cURL theme={null}
  curl -G https://api.upag.dev/v1/apps/b7c8d9e0-f1a2-4b3c-8d4e-5f6a7b8c9d01/logs \
    -H "Authorization: Bearer sk_test_your_api_key" \
    -d "page=1" \
    -d "limit=15"
  ```

  ```javascript Node.js SDK theme={null}
  import { Upag } from 'upag';

  const upag = new Upag('sk_test_your_api_key');

  // upag.apps.logs.list(appId, params)
  const { data, count } = await upag.apps.logs.list('b7c8d9e0-f1a2-4b3c-8d4e-5f6a7b8c9d01', {
    page: 1,
    limit: 15,
  });
  ```
</CodeGroup>

<Note>
  Em produção use `https://api.upag.io/v1` com `sk_live_...`.
</Note>

## Parâmetros

<ParamField path="appId" type="string (uuid)" required>
  ID do app.
</ParamField>

<ParamField query="page" type="integer" default="1">
  Página (mínimo 1).
</ParamField>

<ParamField query="limit" type="integer" default="15">
  Itens por página (mínimo 1).
</ParamField>

## Resposta

`200 OK`

```json Response theme={null}
{
  "data": [
    {
      "id": "d9e0f1a2-b3c4-4d5e-8f6a-7b8c9d0e1f23",
      "app": "b7c8d9e0-f1a2-4b3c-8d4e-5f6a7b8c9d01",
      "event": "invoice.paid",
      "method": "POST",
      "url": "https://api.utmify.com.br/api-credentials/orders",
      "statusCode": 200,
      "duration": 312,
      "request": "{\"transactionId\":\"...\"}",
      "response": "{\"success\":true}",
      "success": true,
      "createdAt": "2026-03-18T12:00:00.000Z"
    }
  ],
  "count": 1
}
```

`404` (`APP_NOT_FOUND`) se o app não existir.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.