---
updatedAt: 2026-06-17T13:12:14.000Z
agentTools:
  projectIndex: https://docs-parceiro.paytime.com.br/llms.txt
---

# Export - Listar exportações de transações

Permite listar os arquivos de exportação de transações gerados na plataforma. Essas exportações podem ser utilizadas para conciliação, auditoria e integração externa, contendo dados consolidados das transações.

<br />

> 🔽
>
> GET urlServidor/v1/marketplace/transactions/exports

**Obs:** A palavra urlServidor deve ser substituída pela url do servidor.

### Parâmetros da Requisição

#### Headers

| Nome              | Tipo                   | Obrigatório | Descrição                                                                                                                                                           |
| ----------------- | ---------------------- | ----------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `integration-key` | string                 | Sim         | Chave de integração.                                                                                                                                                |
| `x-token`         | string                 | Sim         | Token de autenticação. Pode ser encontrado em nosso portal na guia de integração.                                                                                   |
| `Authorization`   | Auth Type Bearer Token | Sim         | Inserir o Bearer Token, gerado na <Anchor target="_blank" href="https://docs-parceiro.paytime.com.br/docs/gerar-token-de-autentica%C3%A7%C3%A3o">rota Auth</Anchor> |

### Exemplo de header da requisição

```Text CURL
curl --request GET \
  --location 'urlServidor/v1/marketplace/transactions/exports?perPage=10&page=1' \
  --header 'integration-key: your_integration_key' \
  --header 'x-token: your_x_token' \
  --header 'Authorization: Bearer {{bearer_token}}'
```

### 📤 Modelo de resposta

```json
{
  "total":2,
  "page": 1,
  "perPage": 20,
  "lastPage": 1,
  "data": [
    {
      "_id": "6a329c462744ea229e4c70",
      "module": "Transações do Gestor",
      "name": "transacoes-gestor - 1781701702731",
      "marketplace_id": "26",
      "status": "READY",
      "created_at": "2026-06-17T13:08:22.732Z",
      "updated_at": "2026-06-17T13:08:22.732Z",
      "size": 1.786,
      "url": "https://catatau-paytime.s3.sa-east-1.amazonaws.com/exports/marketplace/3b0610cf-c20b-4110-a95d-84a3e49a51.csv"
    },
    {
      "_id": "6a31acf22744ea229e4c45",
      "module": "Transações do Gestor",
      "name": "transacoes-gestor - 1781640434288",
      "marketplace_id": "26",
      "status": "READY",
      "created_at": "2026-06-16T20:07:14.289Z",
      "updated_at": "2026-06-16T20:07:14.289Z",
      "size": 1.023,
      "url": "https://catatau-paytime.s3.sa-east-1.amazonaws.com/exports/marketplace/3b0610cf-c20b-4110-a95d-84a3e49a51.csv"
    }
]
}
```

<br />

### 📎 Query Parameters

| Nome    | Tipo          | Obrigatório | Descrição                                                      |
| ------- | ------------- | ----------- | -------------------------------------------------------------- |
| filters | string (JSON) | Não         | JSON com filtros. Campos filtráveis: created\_at,status,module |
| search  | string        | Não         | Texto livre para busca                                         |
| perPage | number        | Não         | Quantidade de registros por página                             |
| page    | number        | Não         | Página atual                                                   |
| sorters | string (JSON) | Não         | JSON com lista de ordenadores. Campos ordenáveis: created\_at  |

### 📊 Campos da resposta

| Campo    | Tipo   | Descrição            |
| -------- | ------ | -------------------- |
| total    | number | Total de registros   |
| page     | number | Página atual         |
| perPage  | number | Registros por página |
| lastPage | number | Total de páginas     |
| data     | array  | Lista de exportações |

### 📄 Objeto data

| Campo           | Tipo   | Descrição                   |
| :-------------- | :----- | :-------------------------- |
| \_id            | string | Identificador da exportação |
| module          | string | Módulo de origem            |
| name            | string | Nome do arquivo             |
| marketplace\_id | number | ID do marketplace           |
| status          | string | Status da exportação        |
| deleted         | string | Data de exclusão            |
| created         | string | Data de criação             |
| updated         | string | Data de atualização         |
| size            | number | Tamanho do arquivo (KB)     |
| url             | string | URL de download do arquivo  |

### 📌 Status da exportação

| Status     | Descrição                        |
| ---------- | -------------------------------- |
| PROCESSING | Arquivo em processamento         |
| READY      | Arquivo disponível para download |
| ERROR      | Erro na geração do arquivo       |

### Códigos de Resposta

Consulte a página com os status: [Status de respostas](status-de-respostas)

Para mais detalhes sobre os parâmetros e funcionamento da API, acesse a [documentação oficial da Paytime](https://paytime-api-parceiro.readme.io/docs/seja-bem-vindo).