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

# Listar Logs SFTP da Campanha

> Listar logs de jobs de importação e exportação SFTP de uma campanha

# Listar Logs SFTP da Campanha

Lista os jobs SFTP recentes de importação e exportação para uma campanha, incluindo status, contagem de arquivos e quaisquer erros.

## Endpoint

```
GET /api/v1/campaigns/{campaign_id}/sftp/logs
```

## Parâmetros de caminho

<ParamField path="campaign_id" type="string" required>UUID da campanha.</ParamField>

## Parâmetros de consulta

<ParamField query="per_page" type="integer">Itens por página. Faixa: `1`–`100`. Padrão: `25`.</ParamField>
<ParamField query="page" type="integer">Padrão: `1`.</ParamField>

## Cabeçalhos da requisição

<ParamField header="Authorization" type="string" required>
  Token Bearer. Formato: `Bearer talq_your_environment_token_here`
</ParamField>

## Exemplos

<RequestExample>
  ```bash theme={null}
  curl "https://app.talkover.ai/api/v1/campaigns/campaign-uuid/sftp/logs" \
    -H "Authorization: Bearer talq_your_environment_token_here"
  ```
</RequestExample>

## Resposta

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": [
      {
        "id": "log-uuid-1",
        "type": "import",
        "status": "succeeded",
        "files_processed": 3,
        "rows_processed": 1840,
        "started_at": "2024-01-15T17:00:01Z",
        "completed_at": "2024-01-15T17:00:42Z"
      },
      {
        "id": "log-uuid-2",
        "type": "export",
        "status": "failed",
        "files_processed": 0,
        "error": "Permission denied on /outbox",
        "started_at": "2024-01-15T16:00:00Z"
      }
    ],
    "pagination": {
      "current_page": 1,
      "per_page": 25,
      "total": 18
    }
  }
  ```
</ResponseExample>

### Valores de Status

* `running` — job em andamento
* `succeeded` — concluído com sucesso
* `failed` — concluído com erros
* `cancelled` — cancelado manualmente