> For the complete documentation index, see [llms.txt](https://docs.truedat.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.truedat.io/v8.8/api-integrations/data-quality-apis/executions.md).

# Executions

## Search executions

> Searches executions using the provided filters and returns matching results.

```json
{"openapi":"3.0.0","info":{"title":"td-dq","version":"Truedat 8.8.2"},"paths":{"/api/executions/search":{"post":{"description":"Searches executions using the provided filters and returns matching results.","operationId":"TdDqWeb.ExecutionSearchController.create","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionSearchRequest"}}},"description":"Execution search request","required":false},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionSearchResponse"}}},"description":"Execution search response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqForbiddenResponse"}}},"description":"Forbidden"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Search executions","tags":["Executions"]}}},"components":{"schemas":{"ExecutionSearchRequest":{"additionalProperties":true,"properties":{"filters":{"additionalProperties":true,"description":"Filter criteria","type":"object"},"page":{"default":0,"description":"Page number","minimum":0,"type":"integer"},"size":{"default":20,"description":"Page size","minimum":1,"type":"integer"},"sources":{"description":"Filter by source external IDs","items":{"type":"string"},"nullable":true,"type":"array"},"status":{"description":"Filter by status","nullable":true,"type":"string"}},"title":"ExecutionSearchRequest","type":"object"},"ExecutionSearchResponse":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/Execution"},"type":"array"}},"required":["data"],"title":"ExecutionSearchResponse","type":"object"},"Execution":{"additionalProperties":false,"properties":{"_embedded":{"additionalProperties":false,"nullable":true,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"group":{"additionalProperties":true,"nullable":true,"type":"object"},"implementation":{"additionalProperties":false,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"dynamic_content":{"additionalProperties":true,"nullable":true,"type":"object"},"goal":{"nullable":true,"type":"number"},"id":{"type":"integer"},"implementation_key":{"type":"string"},"minimum":{"nullable":true,"type":"number"},"result_type":{"nullable":true,"type":"string"},"rule_id":{"nullable":true,"type":"integer"}},"required":["id","implementation_key"],"type":"object"},"quality_events":{"items":{"additionalProperties":true,"type":"object"},"nullable":true,"type":"array"},"result":{"additionalProperties":true,"nullable":true,"type":"object"},"rule":{"additionalProperties":false,"nullable":true,"properties":{"id":{"nullable":true,"type":"integer"},"name":{"nullable":true,"type":"string"}},"type":"object"},"status":{"description":"Execution status","nullable":true,"type":"string"}},"type":"object"},"id":{"description":"Execution ID","type":"integer"},"inserted_at":{"description":"Creation timestamp","format":"date-time","type":"string"}},"required":["id","inserted_at"],"title":"Execution","type":"object"},"TdDqUnauthorizedResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqUnauthorizedResponse","type":"object"},"TdDqForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqForbiddenResponse","type":"object"},"TdDqInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqInternalServerErrorResponse","type":"object"}}}}
```

## List executions

> Retrieves executions, optionally filtered by execution group.

```json
{"openapi":"3.0.0","info":{"title":"td-dq","version":"Truedat 8.8.2"},"paths":{"/api/execution_groups/{execution_group_id}/executions":{"get":{"description":"Retrieves executions, optionally filtered by execution group.","operationId":"TdDqWeb.ExecutionController.index (2)","parameters":[{"description":"Filter by execution group ID","in":"query","name":"group_id","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionIndexResponse"}}},"description":"Executions response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqForbiddenResponse"}}},"description":"Forbidden"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"List executions","tags":["Executions"]}}},"components":{"schemas":{"ExecutionIndexResponse":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/Execution"},"type":"array"}},"required":["data"],"title":"ExecutionIndexResponse","type":"object"},"Execution":{"additionalProperties":false,"properties":{"_embedded":{"additionalProperties":false,"nullable":true,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"group":{"additionalProperties":true,"nullable":true,"type":"object"},"implementation":{"additionalProperties":false,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"dynamic_content":{"additionalProperties":true,"nullable":true,"type":"object"},"goal":{"nullable":true,"type":"number"},"id":{"type":"integer"},"implementation_key":{"type":"string"},"minimum":{"nullable":true,"type":"number"},"result_type":{"nullable":true,"type":"string"},"rule_id":{"nullable":true,"type":"integer"}},"required":["id","implementation_key"],"type":"object"},"quality_events":{"items":{"additionalProperties":true,"type":"object"},"nullable":true,"type":"array"},"result":{"additionalProperties":true,"nullable":true,"type":"object"},"rule":{"additionalProperties":false,"nullable":true,"properties":{"id":{"nullable":true,"type":"integer"},"name":{"nullable":true,"type":"string"}},"type":"object"},"status":{"description":"Execution status","nullable":true,"type":"string"}},"type":"object"},"id":{"description":"Execution ID","type":"integer"},"inserted_at":{"description":"Creation timestamp","format":"date-time","type":"string"}},"required":["id","inserted_at"],"title":"Execution","type":"object"},"TdDqUnauthorizedResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqUnauthorizedResponse","type":"object"},"TdDqForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqForbiddenResponse","type":"object"},"TdDqInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqInternalServerErrorResponse","type":"object"}}}}
```

## List executions

> Retrieves executions, optionally filtered by execution group.

```json
{"openapi":"3.0.0","info":{"title":"td-dq","version":"Truedat 8.8.2"},"paths":{"/api/executions":{"get":{"description":"Retrieves executions, optionally filtered by execution group.","operationId":"TdDqWeb.ExecutionController.index","parameters":[{"description":"Filter by execution group ID","in":"query","name":"group_id","required":false,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionIndexResponse"}}},"description":"Executions response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqForbiddenResponse"}}},"description":"Forbidden"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"List executions","tags":["Executions"]}}},"components":{"schemas":{"ExecutionIndexResponse":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/Execution"},"type":"array"}},"required":["data"],"title":"ExecutionIndexResponse","type":"object"},"Execution":{"additionalProperties":false,"properties":{"_embedded":{"additionalProperties":false,"nullable":true,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"group":{"additionalProperties":true,"nullable":true,"type":"object"},"implementation":{"additionalProperties":false,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"dynamic_content":{"additionalProperties":true,"nullable":true,"type":"object"},"goal":{"nullable":true,"type":"number"},"id":{"type":"integer"},"implementation_key":{"type":"string"},"minimum":{"nullable":true,"type":"number"},"result_type":{"nullable":true,"type":"string"},"rule_id":{"nullable":true,"type":"integer"}},"required":["id","implementation_key"],"type":"object"},"quality_events":{"items":{"additionalProperties":true,"type":"object"},"nullable":true,"type":"array"},"result":{"additionalProperties":true,"nullable":true,"type":"object"},"rule":{"additionalProperties":false,"nullable":true,"properties":{"id":{"nullable":true,"type":"integer"},"name":{"nullable":true,"type":"string"}},"type":"object"},"status":{"description":"Execution status","nullable":true,"type":"string"}},"type":"object"},"id":{"description":"Execution ID","type":"integer"},"inserted_at":{"description":"Creation timestamp","format":"date-time","type":"string"}},"required":["id","inserted_at"],"title":"Execution","type":"object"},"TdDqUnauthorizedResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqUnauthorizedResponse","type":"object"},"TdDqForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqForbiddenResponse","type":"object"},"TdDqInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqInternalServerErrorResponse","type":"object"}}}}
```

## Get execution group

> Retrieves detailed information for the specified execution group.

```json
{"openapi":"3.0.0","info":{"title":"td-dq","version":"Truedat 8.8.2"},"paths":{"/api/execution_groups/{id}":{"get":{"description":"Retrieves detailed information for the specified execution group.","operationId":"TdDqWeb.ExecutionGroupController.show","parameters":[{"description":"Execution group ID","in":"path","name":"id","required":true,"schema":{"type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionGroupShowResponse"}}},"description":"Execution group response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqForbiddenResponse"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqNotFoundResponse"}}},"description":"Not found"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Get execution group","tags":["Executions"]}}},"components":{"schemas":{"ExecutionGroupShowResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ExecutionGroup"}},"required":["data"],"title":"ExecutionGroupShowResponse","type":"object"},"ExecutionGroup":{"additionalProperties":false,"properties":{"_embedded":{"additionalProperties":false,"nullable":true,"properties":{"executions":{"description":"List of executions","items":{"$ref":"#/components/schemas/Execution"},"type":"array"}},"type":"object"},"df_content":{"additionalProperties":true,"description":"Dynamic content","nullable":true,"type":"object"},"id":{"description":"Execution group ID","type":"integer"},"inserted_at":{"description":"Creation timestamp","format":"date-time","type":"string"}},"required":["id","inserted_at"],"title":"ExecutionGroup","type":"object"},"Execution":{"additionalProperties":false,"properties":{"_embedded":{"additionalProperties":false,"nullable":true,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"group":{"additionalProperties":true,"nullable":true,"type":"object"},"implementation":{"additionalProperties":false,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"dynamic_content":{"additionalProperties":true,"nullable":true,"type":"object"},"goal":{"nullable":true,"type":"number"},"id":{"type":"integer"},"implementation_key":{"type":"string"},"minimum":{"nullable":true,"type":"number"},"result_type":{"nullable":true,"type":"string"},"rule_id":{"nullable":true,"type":"integer"}},"required":["id","implementation_key"],"type":"object"},"quality_events":{"items":{"additionalProperties":true,"type":"object"},"nullable":true,"type":"array"},"result":{"additionalProperties":true,"nullable":true,"type":"object"},"rule":{"additionalProperties":false,"nullable":true,"properties":{"id":{"nullable":true,"type":"integer"},"name":{"nullable":true,"type":"string"}},"type":"object"},"status":{"description":"Execution status","nullable":true,"type":"string"}},"type":"object"},"id":{"description":"Execution ID","type":"integer"},"inserted_at":{"description":"Creation timestamp","format":"date-time","type":"string"}},"required":["id","inserted_at"],"title":"Execution","type":"object"},"TdDqUnauthorizedResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqUnauthorizedResponse","type":"object"},"TdDqForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqForbiddenResponse","type":"object"},"TdDqNotFoundResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqNotFoundResponse","type":"object"},"TdDqInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqInternalServerErrorResponse","type":"object"}}}}
```

## List execution groups

> Retrieves all execution groups available to the current user.

```json
{"openapi":"3.0.0","info":{"title":"td-dq","version":"Truedat 8.8.2"},"paths":{"/api/execution_groups":{"get":{"description":"Retrieves all execution groups available to the current user.","operationId":"TdDqWeb.ExecutionGroupController.index","parameters":[],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionGroupIndexResponse"}}},"description":"Execution groups response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqForbiddenResponse"}}},"description":"Forbidden"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"List execution groups","tags":["Executions"]}}},"components":{"schemas":{"ExecutionGroupIndexResponse":{"additionalProperties":false,"properties":{"data":{"items":{"$ref":"#/components/schemas/ExecutionGroup"},"type":"array"}},"required":["data"],"title":"ExecutionGroupIndexResponse","type":"object"},"ExecutionGroup":{"additionalProperties":false,"properties":{"_embedded":{"additionalProperties":false,"nullable":true,"properties":{"executions":{"description":"List of executions","items":{"$ref":"#/components/schemas/Execution"},"type":"array"}},"type":"object"},"df_content":{"additionalProperties":true,"description":"Dynamic content","nullable":true,"type":"object"},"id":{"description":"Execution group ID","type":"integer"},"inserted_at":{"description":"Creation timestamp","format":"date-time","type":"string"}},"required":["id","inserted_at"],"title":"ExecutionGroup","type":"object"},"Execution":{"additionalProperties":false,"properties":{"_embedded":{"additionalProperties":false,"nullable":true,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"group":{"additionalProperties":true,"nullable":true,"type":"object"},"implementation":{"additionalProperties":false,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"dynamic_content":{"additionalProperties":true,"nullable":true,"type":"object"},"goal":{"nullable":true,"type":"number"},"id":{"type":"integer"},"implementation_key":{"type":"string"},"minimum":{"nullable":true,"type":"number"},"result_type":{"nullable":true,"type":"string"},"rule_id":{"nullable":true,"type":"integer"}},"required":["id","implementation_key"],"type":"object"},"quality_events":{"items":{"additionalProperties":true,"type":"object"},"nullable":true,"type":"array"},"result":{"additionalProperties":true,"nullable":true,"type":"object"},"rule":{"additionalProperties":false,"nullable":true,"properties":{"id":{"nullable":true,"type":"integer"},"name":{"nullable":true,"type":"string"}},"type":"object"},"status":{"description":"Execution status","nullable":true,"type":"string"}},"type":"object"},"id":{"description":"Execution ID","type":"integer"},"inserted_at":{"description":"Creation timestamp","format":"date-time","type":"string"}},"required":["id","inserted_at"],"title":"Execution","type":"object"},"TdDqUnauthorizedResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqUnauthorizedResponse","type":"object"},"TdDqForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqForbiddenResponse","type":"object"},"TdDqInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqInternalServerErrorResponse","type":"object"}}}}
```

## Create execution group

> Creates a new execution group using the provided execution parameters.

```json
{"openapi":"3.0.0","info":{"title":"td-dq","version":"Truedat 8.8.2"},"paths":{"/api/execution_groups":{"post":{"description":"Creates a new execution group using the provided execution parameters.","operationId":"TdDqWeb.ExecutionGroupController.create","parameters":[],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionGroupCreateRequest"}}},"description":"Execution group creation request","required":false},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ExecutionGroupShowResponse"}}},"description":"Execution group response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqUnauthorizedResponse"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqForbiddenResponse"}}},"description":"Forbidden"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqUnprocessableEntityResponse"}}},"description":"Unprocessable Entity"},"500":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TdDqInternalServerErrorResponse"}}},"description":"Internal Server Error"}},"summary":"Create execution group","tags":["Executions"]}}},"components":{"schemas":{"ExecutionGroupCreateRequest":{"additionalProperties":false,"oneOf":[{"properties":{"df_content":{"additionalProperties":true,"description":"Dynamic content","nullable":true,"type":"object"},"implementation_ids":{"description":"List of implementation IDs to execute","items":{"type":"integer"},"type":"array"}},"required":["implementation_ids"],"type":"object"},{"properties":{"df_content":{"additionalProperties":true,"description":"Dynamic content","nullable":true,"type":"object"},"filters":{"additionalProperties":true,"description":"Search filters to select implementations (e.g., {\"id\": [1,2]})","type":"object"}},"required":["filters"],"type":"object"},{"properties":{"df_content":{"additionalProperties":true,"description":"Dynamic content","nullable":true,"type":"object"},"executions":{"description":"Direct list of execution objects","items":{"additionalProperties":false,"properties":{"implementation_id":{"type":"integer"}},"required":["implementation_id"],"type":"object"},"type":"array"}},"required":["executions"],"type":"object"}],"title":"ExecutionGroupCreateRequest","type":"object"},"ExecutionGroupShowResponse":{"additionalProperties":false,"properties":{"data":{"$ref":"#/components/schemas/ExecutionGroup"}},"required":["data"],"title":"ExecutionGroupShowResponse","type":"object"},"ExecutionGroup":{"additionalProperties":false,"properties":{"_embedded":{"additionalProperties":false,"nullable":true,"properties":{"executions":{"description":"List of executions","items":{"$ref":"#/components/schemas/Execution"},"type":"array"}},"type":"object"},"df_content":{"additionalProperties":true,"description":"Dynamic content","nullable":true,"type":"object"},"id":{"description":"Execution group ID","type":"integer"},"inserted_at":{"description":"Creation timestamp","format":"date-time","type":"string"}},"required":["id","inserted_at"],"title":"ExecutionGroup","type":"object"},"Execution":{"additionalProperties":false,"properties":{"_embedded":{"additionalProperties":false,"nullable":true,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"group":{"additionalProperties":true,"nullable":true,"type":"object"},"implementation":{"additionalProperties":false,"properties":{"df_content":{"additionalProperties":true,"nullable":true,"type":"object"},"dynamic_content":{"additionalProperties":true,"nullable":true,"type":"object"},"goal":{"nullable":true,"type":"number"},"id":{"type":"integer"},"implementation_key":{"type":"string"},"minimum":{"nullable":true,"type":"number"},"result_type":{"nullable":true,"type":"string"},"rule_id":{"nullable":true,"type":"integer"}},"required":["id","implementation_key"],"type":"object"},"quality_events":{"items":{"additionalProperties":true,"type":"object"},"nullable":true,"type":"array"},"result":{"additionalProperties":true,"nullable":true,"type":"object"},"rule":{"additionalProperties":false,"nullable":true,"properties":{"id":{"nullable":true,"type":"integer"},"name":{"nullable":true,"type":"string"}},"type":"object"},"status":{"description":"Execution status","nullable":true,"type":"string"}},"type":"object"},"id":{"description":"Execution ID","type":"integer"},"inserted_at":{"description":"Creation timestamp","format":"date-time","type":"string"}},"required":["id","inserted_at"],"title":"Execution","type":"object"},"TdDqUnauthorizedResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqUnauthorizedResponse","type":"object"},"TdDqForbiddenResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqForbiddenResponse","type":"object"},"TdDqUnprocessableEntityResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqUnprocessableEntityResponse","type":"object"},"TdDqInternalServerErrorResponse":{"properties":{"errors":{"properties":{"detail":{"type":"string"}},"type":"object"}},"title":"TdDqInternalServerErrorResponse","type":"object"}}}}
```