---
title: 8.7. Consultar Execuções do Ciclo
url: https://docs.vehub.com.br/API/Cadastro%20de%20Cedente/8.%20Antecipa%C3%A7%C3%A3o%20autom%C3%A1tica%20de%20cart%C3%A3o/8.7.%20Consultar%20Execu%C3%A7%C3%B5es%20do%20Ciclo/
---
Histórico paginado dos ciclos de antecipação automática de um cedente.

É por aqui que se descobre **por que** um determinado dia não gerou contrato — e de onde veio a agenda que originou os contratos que foram gerados.

!!! tip "O ciclo rodar e não contratar é um desfecho normal"
    Agenda vazia, total abaixo do valor mínimo configurado, nenhuma UR elegível: em todos esses casos o ciclo executa, não gera contrato e registra o motivo. Não é erro. O campo `motivoNaoContratacao` diz qual foi o caso.

---

## Consultar Execuções do Ciclo

| Método                                        | URL                                                                                    |
| --------------------------------------------- | -------------------------------------------------------------------------------------- |
| ![GET](https://img.shields.io/badge/GET-blue) | `https://BASE_URL/public/api/v1/cedentes/{idEmpresa}/antecipacao-automatica/execucoes`  |

### Path Params

| Campo       | Tipo   | Descrição                         |
| ----------- | ------ | --------------------------------- |
| `idEmpresa` | Número | Identificador da empresa cedente. |

### 🔍 Filtros (query string)

| Parâmetro     | Tipo   | Obrigatório | Descrição                                                                    |
| ------------- | ------ | ----------- | ---------------------------------------------------------------------------- |
| `idOperacao`  | Número | Não         | Filtra uma operação.                                                         |
| `dataInicial` | Texto  | Não         | Considera ciclos a partir desta data, no formato `YYYY-MM-DD`.               |
| `dataFinal`   | Texto  | Não         | Considera ciclos até esta data, no formato `YYYY-MM-DD`.                     |
| `status`      | Número | Não         | Filtra pelo desfecho do ciclo. Ver [8.8](8.8.%20Status%20e%20Enumera%C3%A7%C3%B5es.md). |
| `origemAgenda`| Número | Não         | Filtra pela origem da agenda. Ver [8.8](8.8.%20Status%20e%20Enumera%C3%A7%C3%B5es.md).  |

### 📄 Paginação

| Parâmetro         | Tipo   | Obrigatório | Padrão | Descrição                             |
| ----------------- | ------ | ----------- | ------ | ------------------------------------- |
| `indicePagina`    | Número | Não         | `1`    | Página desejada do resultado.         |
| `tamanhoDaPagina` | Número | Não         | `20`   | Quantidade de registros por página. Máximo de 100. |

```json title="Response Body — 200 OK"
{
  "registros": [
    {
      "data": "2026-09-22",
      "idOperacao": 1,
      "origemAgenda": 1,
      "status": 2,
      "identificadorContrato": "534D8AAE-61E4-4264-9D15-715B9E1F1D51",
      "valorContratado": 18422.15,
      "taxaAplicada": 1.9900,
      "quantidadeUrs": 37,
      "motivoNaoContratacao": null
    },
    {
      "data": "2026-09-19",
      "idOperacao": 1,
      "origemAgenda": 2,
      "status": 3,
      "identificadorContrato": null,
      "valorContratado": null,
      "taxaAplicada": null,
      "quantidadeUrs": 0,
      "motivoNaoContratacao": 2
    }
  ],
  "paginacao": {
    "paginaAtual": 1,
    "paginaTotal": 1,
    "paginaQuantidadeRegistro": 2,
    "quantidadeRegistros": 2,
    "temPaginaAnterior": false,
    "temProximaPagina": false
  },
  "mensagem": "Execuções listadas com sucesso!"
}
```

### Detalhamento dos Campos

#### 🔹 registros

| Campo                   | Tipo    | Descrição                                                                                                |
| ----------------------- | ------- | ---------------------------------------------------------------------------------------------------------- |
| `data`                  | Texto   | Data do ciclo, no formato `YYYY-MM-DD`.                                                                    |
| `idOperacao`            | Número  | Operação em que o ciclo rodou.                                                                             |
| `origemAgenda`          | Número  | `1` agenda BATCH, `2` agenda ONLINE. Ver [8.8](8.8.%20Status%20e%20Enumera%C3%A7%C3%B5es.md).               |
| `status`                | Número  | Desfecho do ciclo. Ver [8.8](8.8.%20Status%20e%20Enumera%C3%A7%C3%B5es.md).                                 |
| `identificadorContrato` | Texto   | GUID do contrato gerado. `null` quando não houve contrato. Use-o nos endpoints de contrato da API de recebíveis de cartão. |
| `valorContratado`       | Decimal | Valor efetivamente contratado. `null` quando não houve contrato.                                           |
| `taxaAplicada`          | Decimal | Deságio aplicado no contrato. `null` quando não houve contrato.                                            |
| `quantidadeUrs`         | Número  | Quantidade de unidades de recebíveis cedidas no contrato.                                                  |
| `motivoNaoContratacao`  | Número  | Por que não houve contrato. `null` quando houve. Ver [8.8](8.8.%20Status%20e%20Enumera%C3%A7%C3%B5es.md).   |

#### 🔹 paginacao

| Campo                      | Tipo     | Descrição                                               |
| -------------------------- | -------- | ------------------------------------------------------- |
| `paginaAtual`              | Número   | Página retornada nesta resposta.                        |
| `paginaTotal`              | Número   | Total de páginas disponíveis com os filtros informados. |
| `paginaQuantidadeRegistro` | Número   | Quantidade de registros nesta página.                   |
| `quantidadeRegistros`      | Número   | Total de registros que atendem aos filtros.             |
| `temPaginaAnterior`        | Booleano | Indica se existe página anterior.                       |
| `temProximaPagina`         | Booleano | Indica se existe próxima página.                        |

!!! info "Do ciclo ao contrato"
    Com o `identificadorContrato` em mãos, consulte os detalhes e as URs em [Detalhes do contrato](../../VeFlow%20-%20Cart%C3%A3o%20de%20cr%C3%A9dito/5.%20Contrato%20de%20receb%C3%ADveis/v1.1/5.3.%20Detalhes%20do%20contrato.md). Para listar todos os contratos do cedente de uma vez, inclusive os que não vieram do ciclo automático, use [Listar contratos](../../VeFlow%20-%20Cart%C3%A3o%20de%20cr%C3%A9dito/5.%20Contrato%20de%20receb%C3%ADveis/v1.1/5.2.%20Listar%20contratos.md). O mesmo identificador chega em `contrato.identificador` no [webhook de contratos](../../VeFlow%20-%20Cart%C3%A3o%20de%20cr%C3%A9dito/3.%20Notifica%C3%A7%C3%B5es%20-%20WebHook/3.2.%20Atualiza%C3%A7%C3%B5es%20do%20contrato.md) — é por ele que se cruza a notificação com a execução que a originou.

### Erros

| Status | Quando acontece                                                   |
| ------ | ----------------------------------------------------------------- |
| `400`  | Parâmetro de paginação fora do intervalo permitido.               |
| `401`  | Token ausente, expirado ou sem permissão de acesso à API pública. |
| `403`  | Grupo econômico não habilitado para antecipação automática.       |
| `404`  | Cedente não encontrado.                                           |