Skip to main content
Version: 0.18.9


class great_expectations.checkpoint.types.checkpoint_result.CheckpointResult(run_id: RunIdentifier, run_results: dict[ValidationResultIdentifier, dict[str, ExpectationSuiteValidationResult | dict | str]], checkpoint_config: CheckpointConfig, validation_result_url: Optional[str] = None, success: Optional[bool] = None)#

Object returned by

The run_results property forms the backbone of this type and defines the basic contract for what a checkpoint's run method returns. It is a dictionary where the top-level keys are the ValidationResultIdentifiers of the validation results generated in the run. Each value is a dictionary having at minimum, a "validation_result" key containing an ExpectationSuiteValidationResult and an "actions_results" key containing a dictionary where the top-level keys are names of actions performed after that particular validation, with values containing any relevant outputs of that action (at minimum and in many cases, this would just be a dictionary with the action's class_name).

The run_results dictionary can contain other keys that are relevant for a specific checkpoint implementation. For example, the run_results dictionary from a WarningAndFailureExpectationSuiteCheckpoint might have an extra key named "expectation_suite_severity_level" to indicate if the suite is at either a "warning" or "failure" level.

Example run_results Dict:

ValidationResultIdentifier: {
"validation_result": ExpectationSuiteValidationResult,
"actions_results": {
"my_action_name_that_stores_validation_results": {
"class": "StoreValidationResultAction"

  • run_id – An instance of the RunIdentifier class.

  • run_results – A Dict with ValidationResultIdentifier keys and Dict values, which contains at minimum a validation_result key and an action_results key.

  • checkpoint_config – The CheckpointConfig instance used to create this CheckpointResult.

  • success – An optional boolean describing the success of all run_results in this CheckpointResult.

list_expectation_suite_names() List[str]#

Return the list of expecation suite names for a checkpoint.




The list of expectation suite names.

Return type


list_validation_result_identifiers() List[ValidationResultIdentifier]#

Obtain a list of all the ValidationResultIdentifiers used in this CheckpointResult.



List of zero or more ValidationResultIdentifier instances.

list_validation_results(group_by: Literal['validation_result_identifier', 'expectation_suite_name', 'data_asset_name'] | None = None) list[ExpectationSuiteValidationResult] | dict#

Obtain the ExpectationValidationResults belonging to this CheckpointResult.


group_by – Specify how the ExpectationValidationResults should be grouped. Valid options are "validation_result_identifier", "expectation_suite_name", "data_asset_name", or the default None. Providing an invalid group_by value will cause this method to silently fail, and return None.


A list of ExpectationSuiteValidationResult, when group_by=None A dict of ValidationResultIdentifier keys and ExpectationValidationResults

values, when group_by="validation_result_identifier"

A dict of str keys and ExpectationValidationResults values, when

group_by="expectation_suite_name" or group_by="data_asset_name"

None, when group_by is something other than the options described above

to_json_dict() Dict[str, JSONValues]#

Returns a JSON-serializable dict representation of this CheckpointResult.


A JSON-serializable dict representation of this CheckpointResult.