Billing Sessions API - Kore.ai Docs

Back to API List This API retrieves the list of individual billing sessions created for an app so that you can review them for correctness and reconciliation. Billing sessions are tracked at the individual app or bot level. In dynamic routing scenarios, the Parent app functions as a standalone app with its own billing sessions. When the Parent app routes a user query to a linked app, that billing session is attributed to the linked app, not the Parent app. When you select the Parent app in the Admin Console or pass its ID via the API, the system returns only the Parent app’s direct sessions; it doesn’t include sessions routed from the Parent app to linked apps.

Field	Value
Method	POST
Endpoint	For Dialog Builder: `https://{{host}}/api/public/bot/{{BotID}}/getBillingSessionsDetails`; For Admin Console: `https://{{host}}/api/public/bots/getBillingSessionsDetails`
Content Type	`application/json`
Authorization	`auth: {{JWT}}` See How to generate the JWT Token.
API Scope	Dialog Builder: App Settings > Dev Tools > API Scopes > Automation Billing Sessions Admin Console: Security > API Scopes > BotAnalytics > Billing Sessions

Path Parameters

Parameter	Description
`host`	Environment URL, for example, https://platform.kore.ai
`BotID` (when using with Dialog Builder scope)	Bot ID or Stream ID. You can access it from the App Settings page.

Sample Request

For Dialog Builder API scope:

curl --location --request POST 'https://{{host}}/api/public/bot/{{botId}}/getBillingSessionsDetails' \
--header 'auth: {{Auth Token}}' \
--header 'content-type: application/json' \
--data-raw '{
    "fromDate": "2021-02-21",
    "toDate": "2021-07-22",
    "limit": 100,
    "skip": 0
}'

For Admin API scope:

curl --location --request POST 'https://{{host}}/api/public/bots/getBillingSessionsDetails' \
--header 'auth: {{Auth Token}}' \
--header 'content-type: application/json' \
--data-raw '{
    "fromDate": "2021-03-21",
    "toDate": "2021-07-22",
    "limit": 100,
    "skip": 0
}'

Body Parameters

Parameter	Description
`fromDate`	Takes the date format `yyyy-mm-dd` or `yyyy-mm-ddThh:mm:ss.msZ`. Example: `2019-04-01` or `2019-04-01T13:25:58.515Z`
`toDate`	Takes the date format `yyyy-mm-dd` or `yyyy-mm-ddThh:mm:ss.msZ`. A maximum of three months date period is allowed.
`limit (optional)`	Number of records to be shown in the response.
`skip (optional)`	Number of records to be skipped.
`channel (optional)`	The channel code.
`botId (optional when using Admin scope)`	Bot ID or Stream ID. You can access it from the App Settings page of the app.

Sample Response

{
    "total": 2,
    "moreAvailable": true,
    "sessions": [
        {
            "botId": "st-91a4e327-e0b1-5340-bf83-c9cbe57d9e5a",
            "channel": "Microsoft Teams",
            "koreUserId": "u-ea0beee1-71d1-51f1-9fea-687982814f54",
            "channelUserId": "praveen@koredotai.onmicrosoft.com",
            "billingSessionType": "Conversations",
            "conversationSessionId": "6a72d9e6b3e922cd134a2e5b | 6a72dad617f69b00c9f15858 | 6a72d9e6b3e922cd134a2e5b | 6a72dad617f69b00c9f15858",
            "conversationSessionStartDateTime": "08-05-2026 6:36:22 am | 08-05-2026 6:40:22 am | 08-05-2026 6:36:22 am | 08-05-2026 6:40:22 am",
            "conversationSessionEndDateTime": "08-05-2026 6:40:21 am | 08-05-2026 6:48:22 am | 08-05-2026 6:40:21 am | 08-05-2026 6:48:22 am",
            "billingSessionId": "6a72e2a7d483cebaf8e60cf0",
            "billingSessionStartDateTime": "08-05-2026 6:36:23 am",
            "billingSessionEndDateTime": "08-05-2026 6:40:55 am",
            "unitType": "Automation AI"
        },
        {
            "botId": "st-91a4e327-e0b1-5340-bf83-c9cbe57d9e5a",
            "channel": "AgentAssist",
            "koreUserId": "u-ea0beee1-71d1-51f1-9fea-687982814f54",
            "channelUserId": "praveen@koredotai.onmicrosoft.com",
            "billingSessionType": "",
            "conversationSessionId": "6a72dad617f69b00c9f15858 | 6a72dad617f69b00c9f15858",
            "conversationSessionStartDateTime": "08-05-2026 6:40:22 am | 08-05-2026 6:40:22 am",
            "conversationSessionEndDateTime": "08-05-2026 6:48:22 am | 08-05-2026 6:48:22 am",
            "billingSessionId": "6a72e2a7d483cebaf8e60cf2",
            "billingSessionStartDateTime": "08-05-2026 6:45:31 am",
            "billingSessionEndDateTime": "08-05-2026 6:47:15 am",
            "unitType": "Agent AI"
        }
    ]
}

The unitType identifies the product type associated with the billing session. Possible values are Automation AI, Contact Center AI, Smart Assist, Search AI, and Voice.

​Path Parameters

​Sample Request

​Body Parameters

​Sample Response

Path Parameters

Sample Request

Body Parameters

Sample Response