---
title: "Listar eventos de uma execução"
method: GET
path: "/v1/automations/{id}/runs/{runId}/events"
tags: ["Automações"]
---

# Listar eventos de uma execução

`GET /v1/automations/{id}/runs/{runId}/events`

## Request

- Base URL: `https://api.ararahq.com`
- URL: `https://api.ararahq.com/v1/automations/{id}/runs/{runId}/events`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/ararahq/apis/ararahq-api/docs/v1/automations/:id/runs/:runId/events/get.ts> (a function with typed inputs; its response is checked against the schema)

O rastro de uma execução, passo a passo. Responde por que uma pessoa
parou onde parou. Devolve `{ data, pagination }`. Permissão: `READ`.

## Path parameters

- `id` string, uuid, required
- `runId` string, uuid, required

## Query parameters

- `page` integer
- `size` integer

## Response `200`

Página de eventos

- AutomationRunEventPage
  - `data` AutomationRunEvent[], required
    - `id` string, uuid, required
    - `stepId` string, uuid, nullable
    - `kind` string, required: Tipo do evento, ex.: `STARTED`, `QUESTION_ASKED`, `REPLY_MATCHED`, `CHARGE_SENT`, `COMPLETED`.
    - `detail` object, nullable: Muda conforme o `kind`.
    - `createdAt` string, date-time, required
  - `pagination` Pagination, required
    - `page` integer, required: Página atual, começando em `0`.
    - `size` integer, required: Itens por página.
    - `totalElements` integer, required
    - `totalPages` integer, required

## Other responses

- `401`: Chave inexistente, revogada, expirada, com prefixo errado (`ara_` sem `ara_live_`) ou vinda de IP fora da allowlist. O corpo é o JSON padrão do Spring, sem `error.code`.
- `403`: Dois casos, com corpos diferentes: - Autenticação: header `Authorization` ausente, Bearer que não começa com `ara_`, chave sem a permissão da rota ou rota que não aceita chave de API. Corpo no formato padrão do Spring, sem `error.code`. - Regra de negócio, no formato `{ "error": { ... } }`: `PLAN_FEATURE_LOCKED`, `PLAN_LIMIT_REACHED`, `ACCOUNT_NOT_ACTIVATED`, `NO_DEDICATED_NUMBER`, `ORGANIZATION_SUSPENDED`, `NUMBER_BLOCKED`, `FRAUD_SUSPECTED`, `RESOURCE_FORBIDDEN`, `VIEWER_READ_ONLY`.
- `404`: `AUTOMATION_NOT_FOUND` ou `AUTOMATION_RUN_NOT_FOUND`.
- `429`: `RATE_LIMIT_EXCEEDED`: limite geral da API (1.200 leituras ou 3.000 escritas por minuto, por usuário da chave).

## Changes

- **2026-10-12** `d576cd28afc0`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ararahq/apis/ararahq-api/changes/v1/automations/:id/runs/:runId/events/get.md)

---

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