---
title: "Retrieve execution logs for a simulation run"
method: GET
path: "/test_framework/v1/runs/{id}/logs/"
tags: ["test_framework"]
---

# Retrieve execution logs for a simulation run

`GET /test_framework/v1/runs/{id}/logs/`

## Request

- Base URL: `https://api.cekura.ai`
- URL: `https://api.cekura.ai/test_framework/v1/runs/{id}/logs/`
- Auth: one of:
  - API key in header `X-CEKURA-API-KEY`
  - HTTP bearer
  - HTTP bearer
  - API key in header `X-VOCERA-SHAREABLE-LINK-TOKEN`
  - HTTP bearer

Retrieve the provider execution logs captured for a simulation run.

Before calling this tool, retrieve the run with `runs_bulk_retrieve` and confirm that `is_log_present` is true; when it is false no logs were captured. Pass the run's integer `id`, not its provider call identifier. Entries are normalized across providers into `ts`, `level`, `message` and an optional provider-specific `raw`.

## Path parameters

- `id` integer, required

## Response `200`

- RunLogsResponse
  - `provider` string, required: Provider the logs were captured from.
  - `format` string, required: Shape of the source log: `text` for line logs, `events` for structured ones.
  - `fetched_at` string, required: When the logs were captured from the provider.
  - `entries` unknown, required

## Other responses

- `404`: The run does not exist or has no stored execution logs.

## Changes

- **2026-11-03** `a6fb6a739212`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cekura/apis/cekura-api/changes/test_framework/v1/runs/:id/logs/get.md)

---

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