# uip tm teststeplog

> Syntax and options for `uip tm teststeplog list`, which retrieves the execution log for individual steps of a manual or mixed test case run.

`uip tm teststeplog` manages the step-level logs recorded during a test case execution. A test step log captures the outcome of a single step within a test case log, providing granular pass/fail information below the test case level.

## Synopsis

```text
uip tm teststeplog list --test-case-log-id <uuid> [--project-key <key>] [--limit <n>] [--offset <n>]
```

All verbs honor the [global options](./global-options.md) and the standard [exit codes](./exit-codes.md). Every verb accepts `--log-level <level>` (default `Information`).

## uip tm teststeplog list

List the step logs for a specific test case log.

### Arguments

None.

### Options

- `--test-case-log-id <uuid>` *(required)* — UUID of the test case log whose step logs to retrieve. Get this from `uip tm executions testcaselogs list` or `uip tm testcases list-result-history`.
- `--project-key <key>` — owning project. Optional; not required.
- `--limit <n>` — page size. Defaults to `50`.
- `--offset <n>` — results to skip. Defaults to `0`.

### Example

```bash
uip tm teststeplog list \
  --test-case-log-id c3d4e5f6-0000-0000-0000-000000000001
```

### Data shape

```json
{
  "Code": "TestStepLogsList",
  "Data": [
    {
      "Id": "d4e5f6a7-0000-0000-0000-000000000001",
      "StepName": "Navigate to login page",
      "Result": "Passed",
      "Duration": "00:00:02"
    },
    {
      "Id": "d4e5f6a7-0000-0000-0000-000000000002",
      "StepName": "Enter credentials",
      "Result": "Failed",
      "Duration": "00:00:01",
      "ErrorMessage": "Element not found: #password-field"
    }
  ]
}
```

## Related

- [executions testcaselogs list](./uip-test-manager-executions.md#uip-tm-executions-testcaselogs-list) — source of the `--test-case-log-id`.
- [testcaselogs list-assertions](./uip-test-manager-testcases.md#uip-tm-testcaselogs-list-assertions) — assertion-level detail for a test case log.
- [report](./uip-test-manager-report.md) — high-level execution summary.

## See also

- [Test Manager overview](./uip-test-manager.md)