> 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="/files/zqQ0bvwzMjVhSVnz3hRv" 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="/files/TEibyoqDq9kR4Qk5KGFH" 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).