# Retrieve the list of events for a masking execution.

Endpoint: GET /executions/{executionId}/events
Version: 3.23.0
Security: ApiKeyAuth

## Security:

  - `ApiKeyAuth` (unknown)
    apiKey in header Authorization

## Path parameters:

  - `executionId` (string, required)
    The ID of the Execution.

## Query parameters:

  - `limit` (integer)
    Maximum number of objects to return per query. The value must be between 1 and 1000. Default is 100.

  - `cursor` (string)
    Cursor to fetch the next or previous page of results. The value of this property must be extracted from the 'prev_cursor' or 'next_cursor' property of a PaginatedResponseMetadata which is contained in the response of list and search API endpoints.

  - `sort` (string)
    The field to sort results by. A property name with a prepended '-' signifies a descending order.

## Response 200:

  - `200` (unknown)
    OK

## Response 200 fields (application/json):

  - `items` (array)

  - `items.id` (string)
    The ExecutionEvent entity ID.
    Example: 1-EVENT-1

  - `items.execution_id` (string)
    The ID of the execution.
    Example: 414ed52c-fa89-455d-9fb9-9c2fa5115f80

  - `items.execution_component_id` (string)
    The ID of the execution component.
    Example: 123

  - `items.event_type` (string)
    The type of execution event.
    Enum: "JOB_ABORTED", "UNMASKED_DATA", "MASKING_FALLBACK", "FILE_PATTERN_NO_MATCH", "DATA_FETCH_FAIL"

  - `items.severity` (string)
    The severity of the execution event.
    Enum: "INFO", "WARNING", "CRITICAL"

  - `items.cause` (string)
    The cause of the execution event.
    Enum: "UNHANDLED_EXCEPTION", "IGNORED_EXCEPTION", "PATTERN_MATCH_FAILURE", "PREMASK_TYPE_CONVERSION_FAILURE", "POSTMASK_TYPE_CONVERSION_FAILURE", "EXTENDED_ALGORITHM_FAILURE", "DRIVER_SUPPORT_TASK_FAILURE", "DATA_NOT_FOUND_FAILURE", "INVALID_JOB_CONFIGURATION", "DATA_QUERY_TIMEOUT"

  - `items.count` (integer)
    The number of times the execution event occurred.
    Example: 1

  - `items.timestamp` (string)
    The date and time that this execution event first occurred.
    Example: 2023-03-20T08:51:34.148000+00:00

  - `items.masked_object_name` (string)
    The name of the column, field, or other object being masked when this event occurred, if applicable.
    Example: ssn

  - `items.algorithm_name` (string)
    The name of the masking algorithm running when this event occurred, if applicable.
    Example: SsnTK

  - `items.exception_type` (string)
    The Java class of the exception that triggered this event, if applicable.
    Example: SQLException

  - `items.exception_detail` (string)
    The details associated with the Java exception that triggered this event, if applicable.
    Example: Listener refused the connection with the following error: ORA-12505, TNS:listener does not currently know of SID given in connect descriptor

  - `response_metadata` (object)

  - `response_metadata.prev_cursor` (string)
    Pointer to the previous page of results. Use this value as a cursor query parameter in a subsequent request, along with limit, to navigate through the collection by virtual page.

  - `response_metadata.next_cursor` (string)
    Pointer to the next page of results. Use this value as a cursor query parameter in a subsequent request, along with limit, to navigate through the collection by virtual page.

  - `response_metadata.total` (integer)
    The total number of results. This value may not be provided.