---
title: "Get a step logs"
method: GET
path: "/jobs/{job_id}/{step_idx}/logs"
tags: ["Execution"]
---

# Get a step logs

`GET /jobs/{job_id}/{step_idx}/logs`

## Request

- Base URL: `/bk/api` (relative, and the document was published on a file host, not at the API’s origin)
- URL: `/bk/api/jobs/{job_id}/{step_idx}/logs`
- Auth: HTTP bearer

Get a step logs

## Path parameters

- `job_id` integer, required
- `step_idx` integer, required

## Query parameters

- `start` integer, required
- `limit` integer, required
- `order` string
- `filters` string

## Response `200`

A paged array of logs

- Logs
  - `items` Log[]
    - `time` string
    - `message` string
    - `service` string
    - `host` string
    - `level` string
    - `job` integer
    - `tool` string
    - `step` integer
  - `total` integer
  - `bookmarks` object
    - `first` string
    - `last` string
  - `job` Job
    - `id` integer
    - `created` string, date-time
    - `started` string, date-time
    - `finished` string, date-time
    - `completed` string, date-time
    - `duration` string
    - `timeout` integer
    - `name` string
    - `state` integer
    - `completion_status` integer
    - `notes` string
    - `run_id` integer
    - `steps` object[]
    - `agents_group_id` integer
    - `agents_group_name` string
    - `agent_id` integer
    - `agent_name` string
    - `executor` string
    - `system` string

## Other responses

- `default`: unexpected error

## Changes

- **2023-02-23** `5d147d2986fb`: 1 warning
  - deleted the `query` request parameter `internals`
- **2023-01-15** `2a469103383a`: 1 info
  - endpoint added
- **2021-01-31** `6dffc3a4de00`: 1 breaking
  - api path removed without deprecation

[Operation history](https://skmtc.dev/kraken-ci/apis/server-api/changes/jobs/:job_id/:step_idx/logs/get.md)

---

[API](https://skmtc.dev/kraken-ci/apis/server-api.md) - [All operations](https://skmtc.dev/kraken-ci/apis/server-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kraken-ci/apis/server-api/revisions/1f2ae877f985?raw)