---
title: "Listar execuções de agentes"
method: GET
path: "/api/management/ai/agents/executions"
tags: ["ai-agents", "agents", "executions"]
---

# Listar execuções de agentes

`GET /api/management/ai/agents/executions`

Lista as execuções de agentes de IA da empresa, da mais recente para a mais antiga. É um resumo: o texto gerado e os passos de cada execução só aparecem no detalhe. Aceita [paginação](https://docs.olie.ai/api-reference/general/pagination) e [filtros básicos](https://docs.olie.ai/api-reference/general/basic-filters).

## Query parameters

- `page` string
- `perPage` string
- `sort` string
- `filter[agent_id]` string
- `filter[status]` string
- `filter[model]` string
- `filter[error]` string

## Response `200`

Sucesso

- object — Página de execuções de agentes.
  - `data` object[] — Execuções da página atual, da mais recente para a mais antiga.
    - `id` string, uuid — ID (UUID) da execução.
    - `agent_id` string, uuid, nullable — ID (UUID) do agente executado.
    - `agent` object — Agente executado, apenas com os campos de identificação.
      - `id` string, uuid — ID (UUID) do agente.
      - `name` string — Nome do agente.
      - `description` string, nullable — Descrição curta do agente.
    - `model` string, nullable — Modelo de IA usado na execução.
    - `status` 'pending' | 'completed' | 'failed' — Situação da execução: `pending` enquanto está na fila, `completed` quando terminou e `failed` quando falhou.
    - `tokens_used` integer — Total de tokens consumidos pela execução.
    - `credits_debited` string, nullable — Créditos debitados da carteira da empresa, com nove casas decimais; nulo em execuções anteriores à carteira de créditos ou que não chegaram a consumir nada.
    - `latency` integer — Tempo total da execução, em milissegundos.
    - `created_at` string, date-time — Data e hora em que a execução foi enfileirada.
  - `links` object — Endereços das páginas de navegação.
    - `first` string, nullable — Endereço da primeira página.
    - `last` string, nullable — Endereço da última página.
    - `prev` string, nullable — Endereço da página anterior; nulo na primeira página.
    - `next` string, nullable — Endereço da próxima página; nulo na última página.
  - `meta` object — Dados da paginação.
    - `current_page` integer — Página atual.
    - `from` integer, nullable — Posição do primeiro item da página dentro do total; nulo quando a página está vazia.
    - `last_page` integer — Número da última página.
    - `links` object[] — Links prontos para montar a navegação por páginas.
      - `url` string, nullable — Endereço da página; nulo quando o link não leva a lugar nenhum.
      - `label` string — Rótulo do link, como o número da página ou os textos de anterior e próximo.
      - `page` integer, nullable — Número da página do link; nulo nos links desativados.
      - `active` boolean — Indica se o link corresponde à página atual.
    - `path` string — Endereço base usado para montar os links de paginação.
    - `per_page` integer — Quantidade de itens por página.
    - `to` integer, nullable — Posição do último item da página dentro do total; nulo quando a página está vazia.
    - `total` integer — Total de execuções que atendem aos filtros.

## Other responses

- `400` — Ordenação não permitida

## Changes

- **2026-09-22** `d71b18b1685d` — 13 breaking, 3 warning, 3 info
  - the response property `data/items/agent/description` became nullable for the status `200`
  - the response property `data/items/agent_id` became nullable for the status `200`
  - the response property `data/items/credits_debited` became nullable for the status `200`
  - the response property `data/items/model` became nullable for the status `200`
  - …15 more
- **2026-09-22** `b43a04f35145` — 3 warning
  - removed the optional property `links/prev` from the response with the `200` status
  - removed the optional property `meta/links/items/page` from the response with the `200` status
  - removed the optional property `meta/links/items/url` from the response with the `200` status
- **2026-09-18** `468063611950` — 9 info
  - added the new optional `query` request parameter `filter[agent_id]`
  - added the new optional `query` request parameter `filter[error]`
  - added the new optional `query` request parameter `filter[model]`
  - added the new optional `query` request parameter `filter[status]`
  - …5 more

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/ai/agents/executions/get.md)

---

[API](https://skmtc.dev/olie-ai/apis/olie-api.md) · [All operations](https://skmtc.dev/olie-ai/apis/olie-api/llms.txt) · [OpenAPI document](https://skmtc.dev/olie-ai/apis/olie-api/revisions/d71b18b1685d?raw)