> For the complete documentation index, see [llms.txt](https://docs.coherent.global/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.coherent.global/spark-apis/spark-openapi-specification/events-apis.md).

# Events APIs

Access the Spark events.

## Download events post job

> Get an Excel file with the user events logged in Spark. This is equivalent to the \*\*Options\*\*, \*\*Event viewer\*\*, \*\*Download events\*\*.

```json
{"openapi":"3.1.0","info":{"title":"Spark OpenAPI specification","version":"0.1.0"},"tags":[{"name":"Events APIs","description":"Access the Spark events."}],"servers":[{"url":"https://excel.{environment}.coherent.global","variables":{"environment":{"default":"myenvironment"}}}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token can be accessed from the user menu."}},"parameters":{"tenant":{"name":"tenant","in":"path","required":true,"description":"Tenant is part of your sign-in URL and also available in the user menu.","schema":{"type":"string"}}}},"paths":{"/{tenant}/api/v4/events/download":{"post":{"tags":["Events APIs"],"summary":"Download events post job","description":"Get an Excel file with the user events logged in Spark. This is equivalent to the **Options**, **Event viewer**, **Download events**.","operationId":"postEventsDownload","parameters":[{"$ref":"#/components/parameters/tenant"}],"requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"page_no":{"type":["null","integer"],"description":"Page number of the list to get."},"page_size":{"type":["null","integer"],"description":"Number of records per page."},"sort_column":{"type":["null","string"],"description":"String defining the sort column."},"sort_order":{"type":["null","string"],"enum":["asc","desc"],"description":"Set the sort order for `sort_column`."},"search":{"type":["null","array"],"description":"Array of search filter objects.","items":{"type":"object","properties":{"column":{"type":["null","string"],"enum":["folder_id","event_types","service_name","user_name","event_start_date","event_end_date"],"description":"Name of the column to filter."},"value":{"type":["null","string","array"],"description":"Values of the `column` to filter for."}}}}}}}}},"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```

## Download events get job status

> Get an Excel file with the user events logged in Spark. This is equivalent to the \*\*Options\*\*, \*\*Event viewer\*\*, \*\*Download events\*\*.

```json
{"openapi":"3.1.0","info":{"title":"Spark OpenAPI specification","version":"0.1.0"},"tags":[{"name":"Events APIs","description":"Access the Spark events."}],"servers":[{"url":"https://excel.{environment}.coherent.global","variables":{"environment":{"default":"myenvironment"}}}],"security":[{"bearerAuth":[]}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Bearer token can be accessed from the user menu."}},"parameters":{"tenant":{"name":"tenant","in":"path","required":true,"description":"Tenant is part of your sign-in URL and also available in the user menu.","schema":{"type":"string"}},"jobId":{"name":"jobId","in":"path","required":true,"description":"`job_id` associated from `POST` job.","schema":{"type":"string","format":"uuid"}}}},"paths":{"/{tenant}/api/v4/events/download/{jobId}/status":{"get":{"tags":["Events APIs"],"summary":"Download events get job status","description":"Get an Excel file with the user events logged in Spark. This is equivalent to the **Options**, **Event viewer**, **Download events**.","operationId":"getEventsDownloadStatus","parameters":[{"$ref":"#/components/parameters/tenant"},{"$ref":"#/components/parameters/jobId"}],"responses":{"200":{"description":"OK","content":{"application/json":{"schema":{"type":"object"}}}}}}}}}
```