---
title: "Get the list of the Results"
method: GET
path: "/v1alpha2/parents/{parent}/results"
tags: ["Results"]
---

# Get the list of the Results

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

## Request

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

Results can be read across parents by specifying `-` as the `parent`. This is useful for listing all results stored in the system without prior knowledge about the available parents.

## Response `200`

List of Results with next_page_token

- object: List of Results with next_page_token
  - `results` Result[], required
    - `annotations` object: Arbitrary user provided labels for the result.
    - `uid` string, required: server assigned identified of the Results
    - `name` string, required: User assigned identifier of the Result. Encodes Parent information.
    - `summary` RecordSummary: RecordSummary is a high level overview of a Record, typically representing a "root" record for a result. It includes type agonstic information so that UI's and other tools do not need to be aware of underlying types.
      - `record` string, required: The name of the Record this summary represents.
      - `type` string, required: Identifier of underlying data.
      - `status` 'UNKNOWN' | 'SUCCESS' | 'FAILURE' | 'TIMEOUT' | 'CANCELLED', required: Completion status of the Record.
      - `start_time` string, date-time, required
      - `end_time` string, date-time, required
      - `annotations` object: Key-value pairs representing abitrary underlying record data that clients want to include that aren't covered by the above fields.
    - `created_time` string, date-time: DEPRECATED: Use create_time instead
    - `create_time` string, date-time: Server assigned timestamp for when the result was created.
    - `updated_time` string, date-time: DEPRECATED: Use update_time instead
    - `update_time` string, date-time: Server assigned timestamp for when the result was updated.
    - `id` string: DEPRECATED: use uid instead
    - `etag` string: This is etag for Results. If this is provided on update, it must match the server's etag.
  - `next_page_token` string, required

## Changes

- **2026-07-17** `278d1aed13c1`: 2 breaking, 2 info
  - removed the required property `results/items/summary/endTime` from the response with the `200` status
  - removed the required property `results/items/summary/startTime` from the response with the `200` status
  - added the required property `results/items/summary/end_time` to the response with the `200` status
  - added the required property `results/items/summary/start_time` to the response with the `200` status
- **2025-09-18** `190f8ec31164`: 1 breaking, 4 warning, 5 info
  - removed the required property `nextPageToken` from the response with the `200` status
  - removed the optional property `results/items/createTime` from the response with the `200` status
  - removed the optional property `results/items/createdTime` from the response with the `200` status
  - removed the optional property `results/items/updateTime` from the response with the `200` status
  - …6 more
- **2023-04-03** `8fb26784c7aa`: 3 breaking, 4 warning, 7 info
  - removed the required property `next_page_token` from the response with the `200` status
  - removed the required property `results/items/summary/end_time` from the response with the `200` status
  - removed the required property `results/items/summary/start_time` from the response with the `200` status
  - removed the optional property `results/items/create_time` from the response with the `200` status
  - …10 more

[Operation history](https://skmtc.dev/tektoncd/apis/tekton-results-api-specification/changes/v1alpha2/parents/:parent/results/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)
