list_data_pipeline_executions

DataPipelinesApi.list_data_pipeline_executions(id, role_id, from_time=None, to_time=None, limit=None, offset=None, sortorder=None, sortby=None, projection_expression=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)

List executions for a data pipeline

Returns paginated executions for the pipeline after refreshing RUNNING and STOPPING rows from Glue or Bedrock. Requires any access on the pipeline; empty permission is AUTH-1010 (HTTP 403). Default limit 100, maximum 1000, default sort StartedOn descending. from_time and to_time are not applied. Non-start/end nodes get Timeout 2880 when omitted. Child pipeline nodes may include ChildResourceExecutionId and ChildResourceName.

Parameters:

  • id (str) – DataPipelineId. (required)

  • role_id (str) – Amorphic role ID the request is authorized against. Must be a role the user belongs to. Lambda returns AUTH-1001 (HTTP 403 on v2-dataPipelines, HTTP 400 on v2-downloadLogs) if missing after gateway validation. (required)

  • from_time (str) – Declared in the live spec but not read by get_paginated_data_pipelines_executions_list.

  • to_time (str) – Declared in the live spec but not read by get_paginated_data_pipelines_executions_list.

  • limit (int) – Maximum executions per page. Defaults to 100. Maximum 1000 (GE-1028 / HTTP 403).

  • offset (int) – 1-based page offset.

  • sortorder (str) – Sort direction. Defaults to descending.

  • sortby (str) – Field to sort by. Defaults to StartedOn.

  • projection_expression (str) – Comma-separated execution item keys to include.

  • _request_timeout (int, tuple(int, int), optional) – timeout setting for this request. If one number provided, it will be total request timeout. It can also be a pair (tuple) of (connection, read) timeouts.

  • _request_auth (dict, optional) – set to override the auth_settings for an a single request; this effectively ignores the authentication in the spec for a single request.

  • _content_type (str, Optional) – force content-type for the request.

  • _headers (dict, optional) – set to override the headers for a single request; this effectively ignores the headers in the spec for a single request.

  • _host_index (int, optional) – set to override the host_index for a single request; this effectively ignores the host_index in the spec for a single request.

Return type:

ListDataPipelineExecutionsResponse

Returns:

Returns the result object.

Request and Response Examples

HTTP: GET /data-pipelines/{id}/executions

Success (HTTP 200)

Paginated ListDataPipelineExecutionsResponse.

One completed Glue execution

{
  "Executions": [
    {
      "DataPipelineId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "DataPipelineExecutionId": "wr_abc123",
      "StartedOn": "2026-08-01 10:00:00",
      "CompletedOn": "2026-08-01 10:12:00",
      "ExecutionStatus": "COMPLETED",
      "Nodes": [
        {
          "ModuleType": "etl_job",
          "NodeName": "enrich_orders",
          "JobRunState": "SUCCEEDED",
          "Timeout": 2880
        }
      ]
    }
  ],
  "count": 1,
  "total_count": 1,
  "next_available": "no"
}

Errors

Documented error codes: AUTH-1010, GE-1028, AUTH-1001, GE-1046, GE-1044.

HTTP 400

API Gateway request validation (missing required parameters such as role_id). Lambda InvalidInputException from this function is HTTP 403.

Gateway rejected missing required header

{
  "Message": "Invalid request"
}

HTTP 403

Invalid input or unauthorized.

No permission on the pipeline

{
  "Message": "AUTH-1010 - User  is not authorized to perform this operation"
}

limit greater than 1000

{
  "Message": "GE-1028 - Out of range for items per page, Limit is 1000"
}

Missing role_id

{
  "Message": "AUTH-1001 - Missing role information in event header"
}

Unknown pipeline id

{
  "Message": "GE-1046 - Invalid DataPipelineId id received - 00000000-0000-0000-0000-000000000000"
}

HTTP 500

Backend failure (GenericFailureException, InconsistentMetadataException, or unexpected GE-1044).

Unhandled exception

{
  "Message": "GE-1044 - Unexpected error - An unexpected error occurred."
}