> 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.

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

&#x20;&#x20;

<figure><img src="/files/zqQ0bvwzMjVhSVnz3hRv" alt=""><figcaption><p>Session Events API in a browser tab</p></figcaption></figure>

&#x20; 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.

&#x20;&#x20;

<figure><img src="/files/TEibyoqDq9kR4Qk5KGFH" alt=""><figcaption><p>Session Events results in an automation tool</p></figcaption></figure>

&#x20; 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.

&#x20;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).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.apica.io/platform-docs/test-data-orchestrator-tdo/user-documentation/api-guide/reporting-apis/session-events.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
