> ## Documentation Index
> Fetch the complete documentation index at: https://koreai.mintlify.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Sessions History API

<Badge icon="arrow-left" color="gray">[Back to API List](/ai-for-service/apis/automation/api-list)</Badge>

Retrieves conversation sessions. Returns session metadata, user and bot identifiers, session duration, language, status, and other relevant metrics.

| Field             | Value                                                                                                                                                                                  |
| ----------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Method**        | POST                                                                                                                                                                                   |
| **Endpoint**      | `https://{{host}}/api/public/bot/{{BotID}}/getSessions?containmentType={{containmentType}}` (or `https://{{host}}/api/public/getSessions?containmentType={{containmentType}}` for BAC) |
| **Content Type**  | `application/json`                                                                                                                                                                     |
| **Authorization** | `auth: {{JWT}}` See [How to generate the JWT Token](/ai-for-service/apis/automation/api-introduction/#generating-the-jwt-token).                                                       |
| **API Scope**     | App Builder: Bot Sessions; Admin Console: Bot Analytics > Bot Sessions                                                                                                                 |

## Path Parameters

| Parameter         | Description                                                               |
| ----------------- | ------------------------------------------------------------------------- |
| `host`            | Environment URL, for example, `https://platform.kore.ai`.                 |
| `BotID`           | Bot ID or Stream ID. Access it from the General Settings page of the bot. |
| `containmentType` | Filter results by session type: `dropOff`, `selfService`, or `agent`.     |

## Sample Request

**Without a body:**

```json theme={null}
curl --location --request POST 'https://{{host}}/api/public/getSessions?containmentType={{containmentType}}' \
     --header 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
     --header 'Content-Type: application/json'
```

**With a body:**

```json theme={null}
curl --location --request POST 'https://{{host}}/api/public/getSessions?containmentType={{containmentType}}' \
     --header 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
     --header 'Content-Type: application/json' \
     --data-raw '{
        "skip": 0,
        "limit": 100,
        "dateFrom": "2020-02-11",
        "dateTo": "2020-02-12"
     }'
```

**For a specific bot:**

```json theme={null}
curl --location --request POST 'https://{{host}}/api/public/bot/{{BotId}}/getSessions?containmentType={{containmentType}}' \
     --header 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
     --header 'Content-Type: application/json' \
     --data-raw '{
        "skip": 0,
        "limit": 100,
        "dateFrom": "2020-02-11",
        "dateTo": "2020-02-12"
     }'
```

**For specific session IDs:**

```json theme={null}
curl --location --request POST 'https://{{host}}/api/public/bot/{{BotId}}/getSessions' \
     --header 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
     --header 'Content-Type: application/json' \
     --data-raw '{
        "sessionId": ["6465cf6e4769ed4e822bxxxx","6465cf6e47Q9ed4e822bxxxx"]
     }'
```

**For specific external call IDs:**

```bash theme={null}
curl --location POST 'https://{{host}}/api/public/bot/{{BotId}}/getSessions?callId={{callId}}' \
--header 'auth: {{YOUR_JWT_ACCESS_TOKEN}}' \
--header 'Content-Type: application/json' \
--data '{
    "skip": 0,
    "limit": 100,
    "dateFrom": "2025-03-17",
    "dateTo": "2025-03-19"
}'
```

## Request Body Parameters

| Parameter     | Required | Type   | Description                                                                                                                 |
| ------------- | -------- | ------ | --------------------------------------------------------------------------------------------------------------------------- |
| `userId`      | Optional | String | The user ID (email or enterprise-assigned unique ID).                                                                       |
| `skip/offset` | Optional | Number | Number of messages to skip.                                                                                                 |
| `limit`       | Optional | Number | Number of messages per page. Sessions are returned in descending order of start time.                                       |
| `dateFrom`    | Optional | Date   | Start date in `yyyy-mm-dd` or `yyyy-mm-ddThh:mm:ss.msZ` format. Defaults to 7 days before `dateTo`.                         |
| `dateTo`      | Optional | Date   | End date in `yyyy-mm-dd` or `yyyy-mm-ddThh:mm:ss.msZ` format. Defaults to today if neither date is provided.                |
| `tags`        | Optional | Object | Meta tags to filter conversations.                                                                                          |
| `sessionType` | Optional | String | Filter by session type: `non-interactive` (bot messages without user input) or `interactive` (sessions with user messages). |
| `sessionId`   | Optional |        | Array of up to 50 session IDs. If used, all other filters are ignored.                                                      |