---
title: "List Logs given the Result UID"
method: GET
path: "/v1alpha2/parents/{parent}/results/{result_uid}/logs"
tags: ["Logs"]
---

# List Logs given the Result UID

`GET /v1alpha2/parents/{parent}/results/{result_uid}/logs`

## Request

- Base URL: `https://localhost:8080/apis/results.tekton.dev`
- URL: `https://localhost:8080/apis/results.tekton.dev/v1alpha2/parents/{parent}/results/{result_uid}/logs`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/tektoncd/apis/tekton-results-api-specification/docs/v1alpha2/parents/:parent/results/:result_uid/logs/get.ts> (a function with typed inputs; its response is checked against the schema)

Logs can be read across Results by specifying `-` as the `result_uid` or across parents by specifying `-` as the `parent`. (e.g., **default/results/-** or **-/results/-**). This can be used to read and filter matching Logs without knowing the exact Result name.

## Response `200`

List of Records with next_page_token.

- object: List of Records with next_page_token.
  - `records` Record[], required
    - `id` string: DEPRECATED: use uid instead.
    - `uid` string, required: Server assigned identifier of the Record.
    - `etag` string: The etag for this record. If this is provided on update, it must match the server's etag.
    - `name` string, required: Resource name, must be rooted in parent result
    - `created_time` string, date-time: DEPRECATED: use create_time instead.
    - `create_time` string, date-time: Server assigned timestamp for when the record was created.
    - `updated_time` string, date-time: DEPRECATED: use update_time instead.
    - `update_time` string, date-time: Server assigned timestamp for when the record was updated.
    - `data` Any, required: Any represents lossely typed data to be stored within a Record.
      - `value` string, byte, required: JSON encoded data.
      - `type` 'tekton.dev/v1.PipelineRun' | 'tekton.dev/v1.TaskRun' | 'tekton.dev/v1beta1.PipelineRun' | 'tekton.dev/v1beta1.TaskRun' | 'results.tekton.dev/v1alpha2.Log', required: It is unique identifier if the data type stored in the value. This is used as a type to hint to determine how to unmarshal values. Limited to 128 characters. Currently RecordType can be one of the following: * PipelineRun Record: `tekton.dev/v1beta1.PipelineRun`(older records) or `tekton.dev/v1.PipelineRun` * TaskRun Record: `tekton.dev/v1beta1.TaskRun`(older records) or `tekton.dev/v1.TaskRun` * Log Record: `results.tekton.dev/v1alpha2.Log`(older records) or `results.tekton.dev/v1alpha3.Log`
  - `next_page_token` string, required

## Changes

- **2025-09-18** `190f8ec31164`: 2 breaking, 4 warning, 5 info
  - the `records/items/data/type` response's property type changed from `object` to `string` for status `200`
  - removed the required property `nextPageToken` from the response with the `200` status
  - removed the optional property `records/items/createTime` from the response with the `200` status
  - removed the optional property `records/items/createdTime` from the response with the `200` status
  - …7 more
- **2024-07-15** `d7a357777029`: 2 warning
  - added the new `tekton.dev/v1.PipelineRun` enum value to the `records/items/data/type` response property for the response status `200`
  - added the new `tekton.dev/v1.TaskRun` enum value to the `records/items/data/type` response property for the response status `200`
- **2023-04-03** `8fb26784c7aa`: 2 breaking, 4 warning, 7 info
  - the `records/items/data/type` response's property type changed from `string` to `object` for status `200`
  - removed the required property `next_page_token` from the response with the `200` status
  - removed the optional property `records/items/create_time` from the response with the `200` status
  - removed the optional property `records/items/created_time` from the response with the `200` status
  - …9 more

[Operation history](https://skmtc.dev/tektoncd/apis/tekton-results-api-specification/changes/v1alpha2/parents/:parent/results/:result_uid/logs/get.md)

---

[API](https://skmtc.dev/tektoncd/apis/tekton-results-api-specification.md) - [All operations](https://skmtc.dev/tektoncd/apis/tekton-results-api-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/tektoncd/apis/tekton-results-api-specification/revisions/278d1aed13c1?raw)