Pipeline Runs

List pipeline runs

Changed on Nov 3, 2026

Retrieve a paginated list of pipeline runs for the workspace the credential resolves to.

<Note> `time_from` and `time_to` are optional. If neither is provided, the API returns the last 24 hours of data. If both are provided, the maximum time range per request is 7 days. `time_from` cannot be earlier than 2023-01-01.

From 2026-10-01 the default changed from the last 7 days to the last 24 hours. Pass time_from and time_to explicitly to control the window. </Note>

Filter by multiple statuses, pipeline IDs, or pipeline run IDs using comma-separated values. For example, status=SUCCEEDED,FAILED returns all pipeline runs with either status.

get/pipeline_runs

Request

Base URL
https://app.getorchestra.io/api/engine/public
URL
https://app.getorchestra.io/api/engine/public/pipeline_runs
Auth
- HTTP bearer
- or OAuth 2
  Authorization code: https://app.getorchestra.io/oauth/authorize
  Token URL: https://app.getorchestra.io/oauth/token scopes: orchestra:read

Query parameters

statusstring

Filter by status. Comma-separated values are supported where the parameter accepts multiple values. Valid values: QUEUED, CREATED, RUNNING, SUCCEEDED, WARNING, FAILED, SKIPPED, CANCELLING, CANCELLED.

pageinteger

Page number. Must be greater than or equal to 1.

page_sizeinteger

Number of items per page. Defaults to 50; maximum 100.

time_fromstring date-time nullable

Start of the time window as an ISO 8601 datetime.

time_tostring date-time nullable

End of the time window as an ISO 8601 datetime.

pipeline_idsstring

Filter by pipeline IDs. Provide comma-separated UUIDs for multiple values.

pipeline_run_idsstring

Filter by pipeline run IDs. Provide comma-separated UUIDs for multiple values.

environmentsstring

Filter by environment IDs. Provide comma-separated UUIDs for multiple values.

Headers

X-Orchestra-Account-Idstring uuid4 nullable

Act on this account rather than the one the credential resolves to. Omit it to use the credential's own account. An API key is issued to a single account, so it may only name that account; an OAuth token may name any account its grant covers.

Response

Successful response.

pageinteger required

pageSizeinteger required

totalinteger required

Changes

Nov 3, 2026daf2c16b3057 Revision changes
- warning
  added the new LIGHTDASH_CLEAR_RESULTS_CACHE enum value to the ///////// response property for the response status
- warning
  added the new LIGHTDASH_CLEAR_RESULTS_CACHE enum value to the /////// response property for the response status
Nov 3, 2026e45165e7e223 Revision changes
- breaking
  response property results/items/data/anyOf[subschema #1: PipelineRunModel]/environment/additionalProperties/value list-of-types was widened by adding types array and object to media type application/json of response 200
- breaking
  added to the ////// response property oneOf list for the response status
- breaking
  added to the ///// response property oneOf list for the response status
- breaking
  added to the /////////// response property oneOf list for the response status
- breaking
  added to the ///////// response property oneOf list for the response status
- breaking
  the ////// response's property type changed from object to no type for status
- breaking
  the /////////// response's property type changed from object to no type for status
- breaking
  the ///////// response's property type changed from object to no type for status
- warning
  removed the optional property /////// from the response with the status
- warning
  removed the optional property /////// from the response with the status
- warning
  removed the optional property /////// from the response with the status
- warning
  removed the optional property //////////// from the response with the status
- warning
  removed the optional property //////////// from the response with the status
- warning
  removed the optional property //////////// from the response with the status
- warning
  removed the optional property ////////// from the response with the status
- warning
  removed the optional property ////////// from the response with the status
- warning
  removed the optional property ////////// from the response with the status
- warning
  added the new ANTHROPIC enum value to the ///////// response property for the response status
- warning
  added the new ANTHROPIC enum value to the //////////// response property for the response status
- warning
  added the new ANTHROPIC enum value to the /////// response property for the response status
- warning
  added the new ANTHROPIC enum value to the ////////// response property for the response status
- warning
  added the new ANTHROPIC enum value to the ///////// response property for the response status
- warning
  added the new ANTHROPIC enum value to the //////// response property for the response status
- warning
  added the new ANTHROPIC enum value to the ///// response property for the response status
- warning
  added the new ANTHROPIC_CLAUDE_CHAT enum value to the ///////// response property for the response status
- warning
  added the new ANTHROPIC_CLAUDE_CHAT enum value to the /////// response property for the response status
- warning
  added the new AWS_BATCH enum value to the ///////// response property for the response status
- warning
  added the new AWS_BATCH enum value to the //////////// response property for the response status
- warning
  added the new AWS_BATCH enum value to the /////// response property for the response status
- warning
  added the new AWS_BATCH enum value to the ////////// response property for the response status
- warning
  added the new AWS_BATCH enum value to the ///////// response property for the response status
- warning
  added the new AWS_BATCH enum value to the //////// response property for the response status
- warning
  added the new AWS_BATCH enum value to the ///// response property for the response status
- warning
  added the new AWS_BATCH_SUBMIT_JOB enum value to the ///////// response property for the response status
- warning
  added the new AWS_BATCH_SUBMIT_JOB enum value to the /////// response property for the response status
- warning
  added the new AWS_S3_GET_FILE enum value to the ///////// response property for the response status
- warning
  added the new AWS_S3_GET_FILE enum value to the /////// response property for the response status
- warning
  added the new AWS_S3_PUT_FILE enum value to the ///////// response property for the response status
- warning
  added the new AWS_S3_PUT_FILE enum value to the /////// response property for the response status
- warning
  added the new AWS_SES enum value to the ///////// response property for the response status
- warning
  added the new AWS_SES enum value to the //////////// response property for the response status
- warning
  added the new AWS_SES enum value to the /////// response property for the response status
- warning
  added the new AWS_SES enum value to the ////////// response property for the response status
- warning
  added the new AWS_SES enum value to the ///////// response property for the response status
- warning
  added the new AWS_SES enum value to the //////// response property for the response status
- warning
  added the new AWS_SES enum value to the ///// response property for the response status
- warning
  added the new AWS_SES_SEND_EMAIL enum value to the ///////// response property for the response status
- warning
  added the new AWS_SES_SEND_EMAIL enum value to the /////// response property for the response status
- warning
  added the new AWS_STEP_FUNCTIONS enum value to the ///////// response property for the response status
- warning
  added the new AWS_STEP_FUNCTIONS enum value to the //////////// response property for the response status
- warning
  added the new AWS_STEP_FUNCTIONS enum value to the /////// response property for the response status
- warning
  added the new AWS_STEP_FUNCTIONS enum value to the ////////// response property for the response status
- warning
  added the new AWS_STEP_FUNCTIONS enum value to the ///////// response property for the response status
- warning
  added the new AWS_STEP_FUNCTIONS enum value to the //////// response property for the response status
- warning
  added the new AWS_STEP_FUNCTIONS enum value to the ///// response property for the response status
- warning
  added the new AWS_STEP_FUNCTIONS_START_EXECUTION enum value to the ///////// response property for the response status
- warning
  added the new AWS_STEP_FUNCTIONS_START_EXECUTION enum value to the /////// response property for the response status
- warning
  added the new DREMIO enum value to the ///////// response property for the response status
- warning
  added the new DREMIO enum value to the //////////// response property for the response status
- warning
  added the new DREMIO enum value to the /////// response property for the response status
- warning
  added the new DREMIO enum value to the ////////// response property for the response status
- warning
  added the new DREMIO enum value to the ///////// response property for the response status
- warning
  added the new DREMIO enum value to the //////// response property for the response status
- warning
  added the new DREMIO enum value to the ///// response property for the response status
- warning
  added the new DREMIO_RUN_QUERY enum value to the ///////// response property for the response status
- warning
  added the new DREMIO_RUN_QUERY enum value to the /////// response property for the response status
- warning
  added the new GCP_CLOUD_STORAGE_FILE enum value to the ///////// response property for the response status
- warning
  added the new GCP_CLOUD_STORAGE_GET_FILE enum value to the ///////// response property for the response status
- warning
  added the new GCP_CLOUD_STORAGE_GET_FILE enum value to the /////// response property for the response status
- warning
  added the new GCP_CLOUD_STORAGE_PUT_FILE enum value to the ///////// response property for the response status
- warning
  added the new GCP_CLOUD_STORAGE_PUT_FILE enum value to the /////// response property for the response status
- warning
  added the new HUBSPOT enum value to the ///////// response property for the response status
- warning
  added the new HUBSPOT enum value to the //////////// response property for the response status
- warning
  added the new HUBSPOT enum value to the /////// response property for the response status
- warning
  added the new HUBSPOT enum value to the ////////// response property for the response status
- warning
  added the new HUBSPOT enum value to the ///////// response property for the response status
- warning
  added the new HUBSPOT enum value to the //////// response property for the response status
- warning
  added the new HUBSPOT enum value to the ///// response property for the response status
- warning
  added the new HUBSPOT_IMPORT_RECORDS enum value to the ///////// response property for the response status
- warning
  added the new HUBSPOT_IMPORT_RECORDS enum value to the /////// response property for the response status
- warning
  added the new LIGHTDASH_REFRESH_PRE_AGGREGATE enum value to the ///////// response property for the response status
- warning
  added the new LIGHTDASH_REFRESH_PRE_AGGREGATE enum value to the /////// response property for the response status
- warning
  added the new MARIADB enum value to the ///////// response property for the response status
- warning
  added the new MARIADB enum value to the //////////// response property for the response status
- warning
  added the new MARIADB enum value to the /////// response property for the response status
- warning
  added the new MARIADB enum value to the ////////// response property for the response status
- warning
  added the new MARIADB enum value to the ///////// response property for the response status
- warning
  added the new MARIADB enum value to the //////// response property for the response status
- warning
  added the new MARIADB enum value to the ///// response property for the response status
- warning
  added the new MARIADB_QUERY enum value to the ///////// response property for the response status
- warning
  added the new MARIADB_RUN_QUERY enum value to the ///////// response property for the response status
- warning
  added the new MARIADB_RUN_QUERY enum value to the /////// response property for the response status
- warning
  added the new MONGODB enum value to the ///////// response property for the response status
- warning
  added the new MONGODB enum value to the //////////// response property for the response status
- warning
  added the new MONGODB enum value to the /////// response property for the response status
- warning
  added the new MONGODB enum value to the ////////// response property for the response status
- warning
  added the new MONGODB enum value to the ///////// response property for the response status
- warning
  added the new MONGODB enum value to the //////// response property for the response status
- warning
  added the new MONGODB enum value to the ///// response property for the response status
- warning
  added the new MONGODB_QUERY enum value to the ///////// response property for the response status
- warning
  added the new MONGODB_RUN_COMMAND enum value to the ///////// response property for the response status
- warning
  added the new MONGODB_RUN_COMMAND enum value to the /////// response property for the response status
- warning
  added the new MONGODB_RUN_TEST enum value to the ///////// response property for the response status
- warning
  added the new MONGODB_RUN_TEST enum value to the /////// response property for the response status
- warning
  added the new MYSQL enum value to the ///////// response property for the response status
- warning
  added the new MYSQL enum value to the //////////// response property for the response status
- warning
  added the new MYSQL enum value to the /////// response property for the response status
- warning
  added the new MYSQL enum value to the ////////// response property for the response status
- warning
  added the new MYSQL enum value to the ///////// response property for the response status
- warning
  added the new MYSQL enum value to the //////// response property for the response status
- warning
  added the new MYSQL enum value to the ///// response property for the response status
- warning
  added the new MYSQL_QUERY enum value to the ///////// response property for the response status
- warning
  added the new MYSQL_RUN_QUERY enum value to the ///////// response property for the response status
- warning
  added the new MYSQL_RUN_QUERY enum value to the /////// response property for the response status
- warning
  added the new N8N enum value to the ///////// response property for the response status
- warning
  added the new N8N enum value to the //////////// response property for the response status
- warning
  added the new N8N enum value to the /////// response property for the response status
- warning
  added the new N8N enum value to the ////////// response property for the response status
- warning
  added the new N8N enum value to the ///////// response property for the response status
- warning
  added the new N8N enum value to the //////// response property for the response status
- warning
  added the new N8N enum value to the ///// response property for the response status
- warning
  added the new N8N_RUN_WORKFLOW enum value to the ///////// response property for the response status
- warning
  added the new N8N_RUN_WORKFLOW enum value to the /////// response property for the response status
- warning
  added the new NOTION enum value to the ///////// response property for the response status
- warning
  added the new NOTION enum value to the //////////// response property for the response status
- warning
  added the new NOTION enum value to the /////// response property for the response status
- warning
  added the new NOTION enum value to the ////////// response property for the response status
- warning
  added the new NOTION enum value to the ///////// response property for the response status
- warning
  added the new NOTION enum value to the //////// response property for the response status
- warning
  added the new NOTION enum value to the ///// response property for the response status
- warning
  added the new NOTION_APPEND_BLOCKS enum value to the ///////// response property for the response status
- warning
  added the new NOTION_APPEND_BLOCKS enum value to the /////// response property for the response status
- warning
  added the new NOTION_CREATE_DATABASE_PAGE enum value to the ///////// response property for the response status
- warning
  added the new NOTION_CREATE_DATABASE_PAGE enum value to the /////// response property for the response status
- warning
  added the new NOTION_CREATE_PAGE enum value to the ///////// response property for the response status
- warning
  added the new NOTION_CREATE_PAGE enum value to the /////// response property for the response status
- warning
  added the new NOTION_UPDATE_DATABASE_PAGE enum value to the ///////// response property for the response status
- warning
  added the new NOTION_UPDATE_DATABASE_PAGE enum value to the /////// response property for the response status
- warning
  added the new QUEUED enum value to the ///////// response property for the response status
- warning
  added the new QUEUED enum value to the // response property for the response status
- warning
  added the new QUICKBOOKS enum value to the ///////// response property for the response status
- warning
  added the new QUICKBOOKS enum value to the //////////// response property for the response status
- warning
  added the new QUICKBOOKS enum value to the /////// response property for the response status
- warning
  added the new QUICKBOOKS enum value to the ////////// response property for the response status
- warning
  added the new QUICKBOOKS enum value to the ///////// response property for the response status
- warning
  added the new QUICKBOOKS enum value to the //////// response property for the response status
- warning
  added the new QUICKBOOKS enum value to the ///// response property for the response status
- warning
  added the new QUICKBOOKS_CREATE_ENTITY enum value to the ///////// response property for the response status
- warning
  added the new QUICKBOOKS_CREATE_ENTITY enum value to the /////// response property for the response status
- warning
  added the new RUDDERSTACK_RETL_SYNC enum value to the ///////// response property for the response status
- warning
  added the new RUDDERSTACK_RETL_SYNC enum value to the /////// response property for the response status
- warning
  added the new SALESFORCE enum value to the ///////// response property for the response status
- warning
  added the new SALESFORCE enum value to the //////////// response property for the response status
- warning
  added the new SALESFORCE enum value to the /////// response property for the response status
- warning
  added the new SALESFORCE enum value to the ////////// response property for the response status
- warning
  added the new SALESFORCE enum value to the ///////// response property for the response status
- warning
  added the new SALESFORCE enum value to the //////// response property for the response status
- warning
  added the new SALESFORCE enum value to the ///// response property for the response status
- warning
  added the new SALESFORCE_RUN_ANALYTICS_DATAFLOW enum value to the ///////// response property for the response status
- warning
  added the new SALESFORCE_RUN_ANALYTICS_DATAFLOW enum value to the /////// response property for the response status
- warning
  added the new SFTP_GET_FILE enum value to the ///////// response property for the response status
- warning
  added the new SFTP_GET_FILE enum value to the /////// response property for the response status
- warning
  added the new SFTP_PUT_FILE enum value to the ///////// response property for the response status
- warning
  added the new SFTP_PUT_FILE enum value to the /////// response property for the response status
- warning
  added the new SHAREPOINT enum value to the ///////// response property for the response status
- warning
  added the new SHAREPOINT enum value to the //////////// response property for the response status
- warning
  added the new SHAREPOINT enum value to the /////// response property for the response status
- warning
  added the new SHAREPOINT enum value to the ////////// response property for the response status
- warning
  added the new SHAREPOINT enum value to the ///////// response property for the response status
- warning
  added the new SHAREPOINT enum value to the //////// response property for the response status
- warning
  added the new SHAREPOINT enum value to the ///// response property for the response status
- warning
  added the new SHAREPOINT_FILE enum value to the ///////// response property for the response status
- warning
  added the new SHAREPOINT_GET_FILE enum value to the ///////// response property for the response status
- warning
  added the new SHAREPOINT_GET_FILE enum value to the /////// response property for the response status
- warning
  added the new SHAREPOINT_PUT_FILE enum value to the ///////// response property for the response status
- warning
  added the new SHAREPOINT_PUT_FILE enum value to the /////// response property for the response status
- warning
  added the new TYPESAFE enum value to the ///////// response property for the response status
- warning
  added the new TYPESAFE enum value to the //////////// response property for the response status
- warning
  added the new TYPESAFE enum value to the /////// response property for the response status
- warning
  added the new TYPESAFE enum value to the ////////// response property for the response status
- warning
  added the new TYPESAFE enum value to the ///////// response property for the response status
- warning
  added the new TYPESAFE enum value to the //////// response property for the response status
- warning
  added the new TYPESAFE enum value to the ///// response property for the response status
- warning
  added the new TYPESAFE_JEV_EVALUATE enum value to the ///////// response property for the response status
- warning
  added the new TYPESAFE_JEV_EVALUATE enum value to the /////// response property for the response status
- warning
  added the new dict enum value to the ////// response property for the response status
- warning
  added the new list enum value to the ////// response property for the response status
- warning
  added the new operation_duration_above_baseline enum value to the ///// response property for the response status
- warning
  added the new operation_duration_below_baseline enum value to the ///// response property for the response status
- warning
  added the new pipeline_duration_below_baseline enum value to the ///// response property for the response status
- warning
  added the new task_duration_below_baseline enum value to the ///// response property for the response status
- info
  the endpoint scheme security BearerAuthReadOnly was removed from the API
- info
  added the new optional header request parameter X-Orchestra-Account-Id
- info
  added the optional property // to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property //////////// to the response with the status
- info
  added the optional property ///////////// to the response with the status
- info
  added the optional property ///////// to the response with the status
- info
  added the optional property ////////// to the response with the status
- info
  added the optional property /////////// to the response with the status
- info
  added the optional property /////// to the response with the status
- info
  added the optional property ////////// to the response with the status
- info
  added to the //////// response property anyOf list for the response status
- info
  added to the ////// response property anyOf list for the response status
- info
  added to the ///////////// response property anyOf list for the response status
- info
  added to the /////////// response property anyOf list for the response status
- info
  added to the /////////// response property anyOf list for the response status
- info
  added to the ///////// response property anyOf list for the response status
- info
  removed subschema #1 from the //////// response property anyOf list for the response status
- info
  removed subschema #1 from the ////// response property anyOf list for the response status
- info
  removed subschema #1 from the ///////////// response property anyOf list for the response status
- info
  removed subschema #1 from the /////////// response property anyOf list for the response status
- info
  removed subschema #1 from the /////////// response property anyOf list for the response status
- info
  removed subschema #1 from the ///////// response property anyOf list for the response status
- info
  added discriminator to ////// response property for the response status
- info
  added discriminator to /////////// response property for the response status
- info
  added discriminator to ///////// response property for the response status
- info
  added operation_duration_above_baseline operation_duration_below_baseline pipeline_duration_above_baseline pipeline_duration_below_baseline task_duration_above_baseline task_duration_below_baseline discriminator mapping keys to the ///// response property for the response status
- info
  removed the CLAUDE enum value from the ///////// response property for the response status
- info
  removed the CLAUDE enum value from the //////////// response property for the response status
- info
  removed the CLAUDE enum value from the /////// response property for the response status
- info
  removed the CLAUDE enum value from the ////////// response property for the response status
- info
  removed the CLAUDE enum value from the ///////// response property for the response status
- info
  removed the CLAUDE enum value from the //////// response property for the response status
- info
  removed the CLAUDE enum value from the ///// response property for the response status
- info
  removed the CLAUDE_CHAT enum value from the ///////// response property for the response status
- info
  removed the CLAUDE_CHAT enum value from the /////// response property for the response status
- info
  removed the RESTART_FROM_TASKS enum value from the //// response property for the response status
- info
  response property results/items/pipelineName list-of-types was narrowed by removing types null from media type application/json of response 200

Operation history