---
title: "Listar execuções de um projeto"
method: GET
path: "/api/management/projects/{project}/project-executions"
tags: ["projects", "Execuções"]
---

# Listar execuções de um projeto

`GET /api/management/projects/{project}/project-executions`

Lista as execuções registradas em um projeto, com paginação. Aceita recortes por pessoa, por etapa e por período, e ordenação por início ou término.

Consulte [Filtro básico](https://docs.olie.ai/api-reference/general/basic-filters) e [Paginação](https://docs.olie.ai/api-reference/general/pagination).

## Query parameters

- `page` string
- `perPage` string
- `filter[user_id]` string, uuid
- `filter[funnel_step_id]` integer
- `filter[start_date_gt]` string, date-time
- `filter[end_date_lt]` string, date-time
- `filter[is_running]` string
- `sort` string

## Response `200`

Sucesso

- object — Lista paginada de execuções do projeto.
  - `response` boolean, required — Sempre true quando a operação é concluída.
  - `meta` object — Dados da paginação.
    - `current_page` integer — Página retornada.
    - `from` integer, nullable — Posição do primeiro item da página no total.
    - `to` integer, nullable — Posição do último item da página no total.
    - `last_page` integer — Número da última página.
    - `per_page` integer — Itens por página.
    - `total` integer — Total de itens encontrados.
  - `project_executions` object[], required — Execuções da página.
    - `id` string, uuid — ID (UUID) da execução.
    - `project_id` string, uuid — Projeto em que o tempo foi contado.
    - `user_id` string, uuid — Pessoa que executou.
    - `funnel_step_id` integer — Etapa do funil em que o tempo foi contado.
    - `started_at` string, date-time — Início da contagem.
    - `finished_at` string, date-time, nullable — Término da contagem. `null` enquanto a execução está em andamento.
    - `hourly_rate` number, nullable — Valor hora aplicado. Só aparece para quem tem acesso a custos.
    - `finished_reason` string, nullable — Motivo do encerramento: `self_stop`, `scheduled_stop`, `step_moved`, `project_deleted`, `project_template` ou `step_deleted`.
    - `started_at_real` string, date-time, nullable — Início original, quando o horário foi ajustado depois.
    - `finished_at_real` string, date-time, nullable — Término original, quando o horário foi ajustado depois.
    - `project` object, nullable — Projeto da execução.
    - `user` object, nullable — Pessoa que executou.
    - `funnel_step` object, nullable — Etapa e funil da execução.

## Changes

- **2026-08-24** `3c590152d5b5` — 11 breaking, 12 warning, 2 info
  - the response property `meta/from` became nullable for the status `200`
  - the response property `meta/to` became nullable for the status `200`
  - the response property `project_executions/items/finished_at` became nullable for the status `200`
  - the response property `project_executions/items/finished_reason` became nullable for the status `200`
  - …21 more
- **2026-08-19** `3d619d9db20d` — 4 info
  - api tag `Execuções` added
  - api tag `project-execution` removed
  - api tag `{id}` removed
  - added the media type `application/json` for the response with the status `200`
- **2026-08-19** `d270bef5be29` — 4 info
  - added the new optional `query` request parameter `filter[is_running]`
  - added the new optional `query` request parameter `page`
  - added the new optional `query` request parameter `perPage`
  - added the new optional `query` request parameter `sort`
- **2026-07-21** `37876222995e` — 1 warning
  - deleted the `query` request parameter `export`

[Change history](https://skmtc.dev/olie-ai/apis/olie-api/changes/api/management/projects/:project/project-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-service-production.skmtc.workers.dev/v1/apis/olie-ai/olie-api/revisions/8c9bac94e5ad/schema)