list_data_quality_check_runs¶

DataQualityChecksApi.list_data_quality_check_runs(id, role_id, limit=None, offset=None, sortorder=None, sortby=None, filter_expression=None, projection_expression=None, _request_timeout=None, _request_auth=None, _content_type=None, _headers=None, _host_index=0)¶

List data quality check runs

Returns a paginated list of runs for the data quality check id. Before listing, the handler refreshes run status from Glue and may update DynamoDB run rows. Caller needs any dataset AccessType. Pagination uses 1-based offset (default 1, converted to 0-based) and limit (default 500; no IPV-1050 max enforced on this path) over an in-memory sorted page. Default sortby is DataQualityCheckRunStartTime and default sortorder is desc (non-desc sorts ascending). Response key is Runs plus next_available (“yes” or “no”), count, and total_count. Stop requesting further pages when next_available is “no”. Missing check is IPV-1002 (HTTP 400), not 404. Example: GET /data-quality-checks/{id}/runs?limit=50&offset=1&sortorder=desc This Lambda maps InvalidInputException, UnauthorizedUserException, GenericFailureException, ClientError, and ParamValidationError to HTTP 400. Missing run rows return HTTP 422. Uncaught exceptions return HTTP 500 (EMF-1001 wrapping GE-1044).

Parameters:

id (str) – Data quality check ID whose runs are listed. (required)
role_id (str) – Amorphic role ID the request is authorized against. (required)
limit (str) – Maximum number of runs to return per page. Default is 500.
offset (str) – 1-based page offset. Default is 1 (internally converted to 0-based index).
sortorder (str) – Sort direction. Default is desc. Any value other than desc is treated as ascending.
sortby (str) – DynamoDB attribute name used for in-memory sort. Default is DataQualityCheckRunStartTime.
filter_expression (str) – Comma-separated attr:value pairs combined with AND when querying runs (for example RunStatus:SUCCEEDED).
projection_expression (str) – DynamoDB projection expression limiting attributes returned for each run item.
_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:

ListDataQualityCheckRunsResponse

Returns:

Returns the result object.

Request and Response Examples¶

HTTP: GET /data-quality-checks/{id}/runs

Parameter examples¶

Name	In	Example
`limit`	query	`"50"`
`offset`	query	`"1"`
`sortby`	query	`"DataQualityCheckRunStartTime"`

Success (HTTP 200)¶

Paginated runs list. When next_available is “no”, the caller has reached the last page.

Request / response example

{
  "Runs": [
    {
      "DataQualityCheckId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
      "DataQualityCheckRunId": "c1d2e3f4-a5b6-7890-abcd-ef1234567890",
      "RunStatus": "SUCCEEDED",
      "DataQualityCheckRunStartTime": "2026-08-01 10:00:00"
    }
  ],
  "next_available": "no",
  "count": 1,
  "total_count": 1
}

Errors¶

Documented error codes: IPV-1002, AUTH-1002, EMF-1001, GE-1044.

HTTP 400

Missing/invalid parameters, missing check (IPV-1002), or authorization failure (AUTH-1002). GET also refreshes run status from Glue before listing. Bad sortby keys or malformed filterExpression can surface as HTTP 500. This Lambda maps InvalidInputException, UnauthorizedUserException, GenericFailureException, ClientError, and ParamValidationError to HTTP 400. Missing run rows return HTTP 422. Uncaught exceptions return HTTP 500 (EMF-1001 wrapping GE-1044).

notFound

{
  "Message": "IPV-1002 - Invalid DataQualityCheckId - a1b2c3d4-e5f6-7890-abcd-ef1234567890, resource not found."
}

HTTP 500

Unexpected failure (for example EMF-1001 wrapping GE-1044), including invalid UUID path values that raise uncaught ValueError.