---
title: "Query run results"
method: GET
path: "/projects/{owner}/{name}/results"
tags: ["Runs"]
---

# Query run results

`GET /projects/{owner}/{name}/results`

Retrieve a list of run results.

## Path parameters

- `owner` string, required
- `name` string, required

## Query parameters

- `job_id` string[]
- `status` 'Created' | 'Scheduled' | 'Running' | 'Post-Processing' | 'Failed' | 'Cancelled' | 'Succeeded' | 'Unknown' — Enumaration of allowable status strings
- `page` integer — Page number starting from 1
- `per-page` integer — Number of items per page

## Response `200`

Retrieved

- RunResultList — A list response from a pagination request
  - `page` integer, required — The current page the pagination request is on
  - `per_page` integer, required — The number of pages per pagination request
  - `next_page` integer — The next page, if this on is not the last
  - `page_count` integer, required — The total number of pages
  - `total_count` integer, required — The total number of resources matching the list request
  - `resources` array[], required
    - union[]
      - union
        - StepStringInput — A String input.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Input name.
          - `description` string — Optional description for input.
          - `default` string — Default value to use for an input if a value was not supplied.
          - `alias` union[] — A list of aliases for this input in different platforms.
            - union
              - …
          - `required` boolean — A field to indicate if this input is required. This input needs to be set explicitly even when a default value is provided.
          - `spec` object — An optional JSON Schema specification to validate the input value. You can use validate_spec method to validate a value against the spec.
          - `value` string, required
        - StepIntegerInput — An integer input.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Input name.
          - `description` string — Optional description for input.
          - `default` integer — Default value to use for an input if a value was not supplied.
          - `alias` union[] — A list of aliases for this input in different platforms.
            - union
              - …
          - `required` boolean — A field to indicate if this input is required. This input needs to be set explicitly even when a default value is provided.
          - `spec` object — An optional JSON Schema specification to validate the input value. You can use validate_spec method to validate a value against the spec.
          - `value` integer, required
        - StepNumberInput — A number input.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Input name.
          - `description` string — Optional description for input.
          - `default` number — Default value to use for an input if a value was not supplied.
          - `alias` union[] — A list of aliases for this input in different platforms.
            - union
              - …
          - `required` boolean — A field to indicate if this input is required. This input needs to be set explicitly even when a default value is provided.
          - `spec` object — An optional JSON Schema specification to validate the input value. You can use validate_spec method to validate a value against the spec.
          - `value` number, required
        - StepBooleanInput — The boolean type matches only two special values: True and False.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Input name.
          - `description` string — Optional description for input.
          - `default` boolean — Default value to use for an input if a value was not supplied.
          - `alias` union[] — A list of aliases for this input in different platforms.
            - union
              - …
          - `required` boolean — A field to indicate if this input is required. This input needs to be set explicitly even when a default value is provided.
          - `spec` object — An optional JSON Schema specification to validate the input value. You can use validate_spec method to validate a value against the spec.
          - `value` boolean, required
        - StepFolderInput — A folder input.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Input name.
          - `description` string — Optional description for input.
          - `default` union — The default source for file if the value is not provided.
            - HTTP — HTTP Source A web HTTP to an FTP server or an API for example.
              - …
            - S3 — S3 Source An S3 bucket artifact Source.
              - …
            - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder.
              - …
          - `alias` union[] — A list of aliases for this input in different platforms.
            - union
              - …
          - `required` boolean — A field to indicate if this input is required. This input needs to be set explicitly even when a default value is provided.
          - `spec` object — An optional JSON Schema specification to validate the input value. You can use validate_spec method to validate a value against the spec.
          - `path` string — Path to the target location that the input will be copied to. This path is relative to the working directory where the command is executed.
          - `source` union, required — The path to source the file from.
            - HTTP — HTTP Source A web HTTP to an FTP server or an API for example.
              - …
            - S3 — S3 Source An S3 bucket artifact Source.
              - …
            - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder.
              - …
        - StepFileInput — A file input.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Input name.
          - `description` string — Optional description for input.
          - `default` union — The default source for file if the value is not provided.
            - HTTP — HTTP Source A web HTTP to an FTP server or an API for example.
              - …
            - S3 — S3 Source An S3 bucket artifact Source.
              - …
            - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder.
              - …
          - `alias` union[] — A list of aliases for this input in different platforms.
            - union
              - …
          - `required` boolean — A field to indicate if this input is required. This input needs to be set explicitly even when a default value is provided.
          - `spec` object — An optional JSON Schema specification to validate the input value. You can use validate_spec method to validate a value against the spec.
          - `path` string — Path to the target location that the input will be copied to. This path is relative to the working directory where the command is executed.
          - `extensions` string[] — Optional list of extensions for file. The check for extension is case-insensitive.
          - `source` union, required — The path to source the file from.
            - HTTP — HTTP Source A web HTTP to an FTP server or an API for example.
              - …
            - S3 — S3 Source An S3 bucket artifact Source.
              - …
            - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder.
              - …
        - StepPathInput — A file or a folder input.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Input name.
          - `description` string — Optional description for input.
          - `default` union — The default source for file if the value is not provided.
            - HTTP — HTTP Source A web HTTP to an FTP server or an API for example.
              - …
            - S3 — S3 Source An S3 bucket artifact Source.
              - …
            - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder.
              - …
          - `alias` union[] — A list of aliases for this input in different platforms.
            - union
              - …
          - `required` boolean — A field to indicate if this input is required. This input needs to be set explicitly even when a default value is provided.
          - `spec` object — An optional JSON Schema specification to validate the input value. You can use validate_spec method to validate a value against the spec.
          - `path` string — Path to the target location that the input will be copied to. This path is relative to the working directory where the command is executed.
          - `extensions` string[] — Optional list of extensions for file. The check for extension is case-insensitive.
          - `source` union, required — The path to source the file from.
            - HTTP — HTTP Source A web HTTP to an FTP server or an API for example.
              - …
            - S3 — S3 Source An S3 bucket artifact Source.
              - …
            - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder.
              - …
        - StepArrayInput — A JSON array input.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Input name.
          - `description` string — Optional description for input.
          - `default` unknown[] — Default value to use for an input if a value was not supplied.
            - unknown
          - `alias` union[] — A list of aliases for this input in different platforms.
            - union
              - …
          - `required` boolean — A field to indicate if this input is required. This input needs to be set explicitly even when a default value is provided.
          - `spec` object — An optional JSON Schema specification to validate the input value. You can use validate_spec method to validate a value against the spec.
          - `items_type` 'Generic' | 'String' | 'Integer' | 'Number' | 'Boolean' | 'Array' | 'JSONObject' — Type enum for items in a list. Items can not be files or folder. For a list of files you should copy them to a folder and use FolderInput input instead of using ArrayInput.
          - `value` unknown[], required
            - unknown
        - StepJSONObjectInput — A JSON object input.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Input name.
          - `description` string — Optional description for input.
          - `default` object — Default value to use for an input if a value was not supplied.
          - `alias` union[] — A list of aliases for this input in different platforms.
            - union
              - …
          - `required` boolean — A field to indicate if this input is required. This input needs to be set explicitly even when a default value is provided.
          - `spec` object — An optional JSON Schema specification to validate the input value. You can use validate_spec method to validate a value against the spec.
          - `value` object, required
        - StepStringOutput — A String output.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Output name.
          - `description` string — Optional description for output.
          - `path` string, required — Path to the output file relative to where the function command is executed.
          - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional.
          - `value` string, required
        - StepIntegerOutput — An integer output.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Output name.
          - `description` string — Optional description for output.
          - `path` string, required — Path to the output file relative to where the function command is executed.
          - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional.
          - `value` integer, required
        - StepNumberOutput — A number output.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Output name.
          - `description` string — Optional description for output.
          - `path` string, required — Path to the output file relative to where the function command is executed.
          - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional.
          - `value` number, required
        - StepBooleanOutput — The boolean type matches only two special values: True and False.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Output name.
          - `description` string — Optional description for output.
          - `path` string, required — Path to the output file relative to where the function command is executed.
          - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional.
          - `value` boolean, required
        - StepFolderOutput — A folder output.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Output name.
          - `description` string — Optional description for output.
          - `path` string, required — Path to the output folder relative to where the function command is executed.
          - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional.
          - `source` union, required — The path to source the file from.
            - HTTP — HTTP Source A web HTTP to an FTP server or an API for example.
              - …
            - S3 — S3 Source An S3 bucket artifact Source.
              - …
            - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder.
              - …
        - StepFileOutput — A file output.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Output name.
          - `description` string — Optional description for output.
          - `path` string, required — Path to the output file relative to where the function command is executed.
          - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional.
          - `source` union, required — The path to source the file from.
            - HTTP — HTTP Source A web HTTP to an FTP server or an API for example.
              - …
            - S3 — S3 Source An S3 bucket artifact Source.
              - …
            - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder.
              - …
        - StepPathOutput — A file or a folder output.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Output name.
          - `description` string — Optional description for output.
          - `path` string, required — Path to the output file or folder relative to where the function command is executed.
          - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional.
          - `source` union, required — The path to source the file from.
            - HTTP — HTTP Source A web HTTP to an FTP server or an API for example.
              - …
            - S3 — S3 Source An S3 bucket artifact Source.
              - …
            - ProjectFolder — Project Folder Source This is the path to a folder where files and folders can be sourced. In the context of a desktop run Workflow this folder will correspond to a local folder. In the context of a workflow run on Pollination this folder will correspond to a Project scoped folder.
              - …
        - StepArrayOutput — A JSON array output.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Output name.
          - `description` string — Optional description for output.
          - `path` string, required — Path to the output file relative to where the function command is executed.
          - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional.
          - `items_type` 'Generic' | 'String' | 'Integer' | 'Number' | 'Boolean' | 'Array' | 'JSONObject' — Type enum for items in a list. Items can not be files or folder. For a list of files you should copy them to a folder and use FolderInput input instead of using ArrayInput.
          - `value` unknown[], required
            - unknown
        - StepJSONObjectOutput — A JSON object output.
          - `type` string
          - `annotations` object — An optional dictionary to add annotations to inputs. These annotations will be used by the client side libraries.
          - `name` string, required — Output name.
          - `description` string — Optional description for output.
          - `path` string, required — Path to the output file relative to where the function command is executed.
          - `required` boolean — A boolean to indicate if an artifact output is required. A False value makes the artifact optional.
          - `value` object, required

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/pollination/apis/pollination-server.md) · [All operations](https://skmtc.net/pollination/apis/pollination-server/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/pollination/pollination-server/revisions/c1f3c6d96b31/schema)
