> For the complete documentation index, see [llms.txt](https://docs.apica.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.apica.io/platform-docs/test-data-orchestrator-tdo/user-documentation/api-guide/reporting-apis/session-events.md).

# Session Events

This API can be filtered on a start date and/or an end date and on a specific username, if desired. Data is returned in html format if run in a browser and json if run in an automation program.

Run in a browser tab, with only a start date parameter, it will return information as follows.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FlZQjpzriL8RboXXUwUF1%2Fimage.png?alt=media&amp;token=28463c42-3a4b-40d0-a5fd-860d6c87c898" alt=""><figcaption><p>Session Events API in a browser tab</p></figcaption></figure>

If run from Postman or a similar program, it is sent as a GET call. There is no body, only the URL is needed to run this. The date returns in the results section.

<figure><img src="https://2948796384-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LmzGprckLqwd5v6bs6m%2Fuploads%2FtBhia5qJHayu4q64xFIn%2Fimage.png?alt=media&amp;token=0415a3c8-e9cb-45ea-9a20-e000b668f01a" alt=""><figcaption><p>Session Events results in an automation tool</p></figcaption></figure>

With either option, this shows the TDO ID for the session, the user name, the IP address that was used for access, the date/time for login and logout, whether the session is still active (‘true’) or not (‘false’), and the duration the session was/is active for.

Note that startdate is an inclusive parameter (include sessions starting on this date) but end date is an exclusive parameter (only include sessions ending prior to this date).