Translation Logs - Kore.ai Docs

Back to API List Use this API to fetch translation request and response logs for a bot conversation in ascending order of timestamp within a given date range. These logs help identify and debug issues with translation engine responses.

Method	GET
Endpoint	`https://{{host}}/api/{{version}}/{{botId}}/translationlogs?sessionId={{sessionId}}&fromDate={{fromDate}}&toDate={{toDate}}&limit=50&offset=0`
Content-Type	`application/json`
Authorization	`auth: {{JWT}}` See How to generate the JWT Token
API Scope	App Builder: Debug Logs Admin Console: Not Applicable

Path Parameters

Parameter	Description
`host`	Environment URL, for example, `https://platform.kore.ai`
`version`	Refers to the version of the API. The current version of this API is `1.1`
`botId`	App ID or Stream ID. You can access it from the App Settings —> App Profile page of the app.

Sample Request

curl --location 'https://{{host}}/api/1.1/{{botId}}/translationLogs?{{sessionId}}&fromDate=2026-04-27T00:00:00.000Z&toDate=2026-04-27T23:59:59.999Z&limit=50&offset=0' \
--header 'auth: {{jwt_token}}' \
--header 'Content-Type: application/json' \
--header 'accountId: {{accountId}}'

Query Parameters

Parameter	Description	Type
`sessionId`	Conversation session ID used to fetch translation logs for a specific conversation session.	string, optional
`fromDate`	Start time for fetching logs. Use UTC timestamp format `YYYY-MM-DDTHH:MM:SS.000Z` to avoid time-zone mismatches. Don’t use `YYYY-MM-DD`. For example, `2026-04-27T18:14:06.498Z`. mezone boundaries.	string (datetime), optional
`toDate`	End time for fetching logs. Use UTC timestamp format: `YYYY-MM-DDTHH:MM:SS.000Z`. Example: `2026-04-27T23:59:59.999Z`.	string (datetime), optional
`limit`	Number of records to fetch. The maximum allowed value is `50`. If not specified, the API returns up to `50` records.	integer, optional
`offset`	Number of records to skip before fetching results. If not specified, the API starts from `0`.	integer, optional

To fetch translation logs, provide at least one of the query parameters sessionId or fromDate and toDate.

Sample Response

[
    {
        "sessionId": "69ef6f2737087759a08xxxxx",
        "timestamp": "2026-04-27T14:14:08.458Z",
        "inputPayload": {
            "endPoint": {
                "host": "xxxxxx-translate.laratranslate.com",
                "port": "",
                "path": "/translate",
                "protocol": "https",
                "method": "post",
                "connectorEnabled": false,
                "piiDataEnabled": false
            },
            "headerFields": {
                "Content-Type": "application/json",
                "X-Lara-Access-Key-Id": "15EJ8UGGTKQSA60BVSCE3xxxxx",
                "X-Lara-Access-Key-Secret": "***REDACTED***"
            },
            "payloadFields": {
                "sourceText": "Por favor espere mientras encuentro al agente adecuado para usted",
                "targetLanguage": "es"
            },
            "idp": "none",
            "force_proxy": true,
            "timeout": 20000
        },
        "outputPayload": {
            "translations": [
                "Por favor espere mientras encuentro al agente adecuado para usted"
            ]
        },
        "engine": "custom",
        "statusCode": 200,
        "success": true,
        "batchSize": 1
    },
    {
        "sessionId": "69ef6f2737087759a08xxxxx",
        "timestamp": "2026-04-27T14:15:16.669Z",
        "inputPayload": {
            "endPoint": {
                "host": "xxxxxx-translate.laratranslate.com",
                "port": "",
                "path": "/translate",
                "protocol": "https",
                "method": "post",
                "connectorEnabled": false,
                "piiDataEnabled": false
            },
            "headerFields": {
                "Content-Type": "application/json",
                "X-Lara-Access-Key-Id": "15EJ8UGGTKQSA60BVSCE3xxxxx",
                "X-Lara-Access-Key-Secret": "***REDACTED***"
            },
            "payloadFields": {
                "sourceText": "Thank you for waiting. You are now connected with agent with only credit AND",
                "targetLanguage": "es"
            },
            "idp": "none",
            "force_proxy": true,
            "timeout": 20000
        },
        "outputPayload": {
            "translations": [
                "Gracias por esperar. Ahora estás en contacto con un agente solo con tarjeta de crédito Y"
            ]
        },
        "engine": "custom",
        "statusCode": 200,
        "success": true,
        "batchSize": 1
    },
    {
        "sessionId": "69ef6f2737087759a08xxxxx",
        "timestamp": "2026-04-27T14:15:17.410Z",
        "inputPayload": {
            "endPoint": {
                "host": "xxxxxx-translate.laratranslate.com",
                "port": "",
                "path": "/translate",
                "protocol": "https",
                "method": "post",
                "connectorEnabled": false,
                "piiDataEnabled": false
            },
            "headerFields": {
                "Content-Type": "application/json",
                "X-Lara-Access-Key-Id": "15EJ8UGGTKQSA60BVSCE3xxxxx",
                "X-Lara-Access-Key-Secret": "***REDACTED***"
            },
            "payloadFields": {
                "sourceText": "Please enter intent<>transfer money<>Please wait<>Por favor espere mientras encuentro al agente adecuado para usted<>Thank you for waiting. You are now connected with agent with only credit AND",
                "targetLanguage": "de"
            },
            "idp": "none",
            "force_proxy": true,
            "timeout": 20000,
            "originalIndices": [
                0,
                1,
                2,
                3,
                4
            ]
        },
        "outputPayload": {
            "translations": [
                "Bitte geben Sie den Zweck an&lt;&gt;Geld überweisen&lt;&gt;Bitte warten Sie&lt;&gt;Por favor espere mientras encuentro al agente adecuado para usted&lt;&gt;Vielen Dank für Ihre Geduld. Sie sind jetzt mit einem Mitarbeiter verbunden, der nur Kredit hat UND"
            ]
        },
        "engine": "custom",
        "statusCode": 200,
        "success": true,
        "batchSize": 1
    },
    {
        "sessionId": "69ef6f2737087759a08xxxxx",
        "timestamp": "2026-04-27T14:15:17.423Z",
        "inputPayload": {
            "endPoint": {
                "host": "xxxxxx-translate.laratranslate.com",
                "port": "",
                "path": "/translate",
                "protocol": "https",
                "method": "post",
                "connectorEnabled": false,
                "piiDataEnabled": false
            },
            "headerFields": {
                "Content-Type": "application/json",
                "X-Lara-Access-Key-Id": "15EJ8UGGTKQSA60BVSCExxxxx",
                "X-Lara-Access-Key-Secret": "***REDACTED***"
            },
            "payloadFields": {
                "sourceText": "Please enter intent<>transfer money<>Please wait<>Por favor espere mientras encuentro al agente adecuado para usted<>Thank you for waiting. You are now connected with agent with only credit AND",
                "targetLanguage": "de"
            },
            "idp": "none",
            "force_proxy": true,
            "timeout": 20000,
            "originalIndices": [
                0,
                1,
                2,
                3,
                4
            ]
        },
        "outputPayload": {
            "translations": [
                "Bitte geben Sie den Zweck an&lt;&gt;Geld überweisen&lt;&gt;Bitte warten Sie&lt;&gt;Por favor espere mientras encuentro al agente adecuado para usted&lt;&gt;Vielen Dank für Ihre Geduld. Sie sind jetzt mit einem Mitarbeiter verbunden, der nur Kredit hat UND"
            ]
        },
        "engine": "custom",
        "statusCode": 200,
        "success": true,
        "batchSize": 1
    },
    {
        "sessionId": "69ef6f2737087759a08xxxxx",
        "timestamp": "2026-04-27T14:15:17.627Z",
        "inputPayload": {
            "endPoint": {
                "host": "xxxxxx-translate.laratranslate.com",
                "port": "",
                "path": "/translate",
                "protocol": "https",
                "method": "post",
                "connectorEnabled": false,
                "piiDataEnabled": false
            },
            "headerFields": {
                "Content-Type": "application/json",
                "X-Lara-Access-Key-Id": "15EJ8UGGTKQSA60BVSCE3xxxxx",
                "X-Lara-Access-Key-Secret": "***REDACTED***"
            },
            "payloadFields": {
                "sourceText": "Please enter intent<>transfer money<>Please wait<>Por favor espere mientras encuentro al agente adecuado para usted<>Thank you for waiting. You are now connected with agent with only credit AND",
                "targetLanguage": "de"
            },
            "idp": "none",
            "force_proxy": true,
            "timeout": 20000,
            "originalIndices": [
                0,
                1,
                2,
                3,
                4
            ]
        },
        "outputPayload": {
            "translations": [
                "Bitte geben Sie den Zweck an&lt;&gt;Geld überweisen&lt;&gt;Bitte warten Sie&lt;&gt;Por favor espere mientras encuentro al agente adecuado para usted&lt;&gt;Vielen Dank für Ihre Geduld. Sie sind jetzt mit einem Mitarbeiter verbunden, der nur Kredit hat UND"
            ]
        },
        "engine": "custom",
        "statusCode": 200,
        "success": true,
        "batchSize": 1
    },
    {
        "sessionId": "69ef6f2737087759a08xxxxx",
        "timestamp": "2026-04-27T14:16:05.165Z",
        "inputPayload": {
            "endPoint": {
                "host": "xxxxxx-translate.laratranslate.com",
                "port": "",
                "path": "/translate",
                "protocol": "https",
                "method": "post",
                "connectorEnabled": false,
                "piiDataEnabled": false
            },
            "headerFields": {
                "Content-Type": "application/json",
                "X-Lara-Access-Key-Id": "15EJ8UGGTKQSA60BVSCE3xxxxx",
                "X-Lara-Access-Key-Secret": "***REDACTED***"
            },
            "payloadFields": {
                "sourceText": "agent ahora ha cerrado esta conversación. Comuníquese con nosotros si necesita ayuda nuevamente.",
                "targetLanguage": "es"
            },
            "idp": "none",
            "force_proxy": true,
            "timeout": 20000
        },
        "outputPayload": {
            "translations": [
                "agent ahora ha cerrado esta conversación. Comuníquese con nosotros si necesita ayuda nuevamente."
            ]
        },
        "engine": "custom",
        "statusCode": 200,
        "success": true,
        "batchSize": 1
    },
    {
        "sessionId": "69ef6f2737087759a08xxxxx",
        "timestamp": "2026-04-27T14:16:05.184Z",
        "inputPayload": {
            "endPoint": {
                "host": "xxxxxx-translate.laratranslate.com",
                "port": "",
                "path": "/translate",
                "protocol": "https",
                "method": "post",
                "connectorEnabled": false,
                "piiDataEnabled": false
            },
            "headerFields": {
                "Content-Type": "application/json",
                "X-Lara-Access-Key-Id": "15EJ8UGGTKQSA60BVSCE3xxxxx",
                "X-Lara-Access-Key-Secret": "***REDACTED***"
            },
            "payloadFields": {
                "sourceText": "Por favor, complete la encuesta.",
                "targetLanguage": "es"
            },
            "idp": "none",
            "force_proxy": true,
            "timeout": 20000
        },
        "outputPayload": {
            "translations": [
                "Por favor, complete la encuesta."
            ]
        },
        "engine": "custom",
        "statusCode": 200,
        "success": true,
        "batchSize": 1
    }
]

Response Parameters

Parameter	Description	Type	Example
`sessionId`	Conversation session ID associated with the translation event.	string	`69ef6f2737087759a08xxxxx`
`timestamp`	UTC timestamp when the translation log was recorded.	string (datetime)	`2026-04-27T14:16:05.184Z`
`inputPayload`	Request payload sent to the translation provider. Sensitive keys are masked.	object
`inputPayload.endPoint`	API endpoint configuration details	object
`inputPayload.endPoint.host`	API host URL	string	`xxxxx-translate.laratranslate.com`
`inputPayload.endPoint.port`	Port number (if applicable)	string
`inputPayload.endPoint.path`	API endpoint path	string	`/translate`
`inputPayload.endPoint.protocol`	The protocol used for the request	string	`https`
`inputPayload.endPoint.method`	HTTP method used	string	`post`
`inputPayload.endPoint.connectorEnabled`	Indicates if the connector is enabled	boolean	`false`
`inputPayload.endPoint.connectorEnabled`	Indicates if PII handling is enabled	boolean	`false`
`inputPayload.headerFields`	HTTP headers sent with the request	object
`inputPayload.headerFields.Content-Type`	Content type of the request	string	`"application/json"`
`inputPayload.headerFields.X-Lara-Access-Key-Id`	API access key ID	string	`15EJ8UGGTKQSA60BVSCE3xxxxx`
`inputPayload.headerFields.X-Lara-Access-Key-Secret`	API secret key (masked)	string	`REDACTED`
`inputPayload.payloadFields`	Main request payload	object
`inputPayload.payloadFields.sourceText`	Text to be translated	string	`agent ahora ha cerrado esta conversación. Comuníquese con nosotros si necesita ayuda nuevamente.`
`inputPayload.payloadFields.targetLanguage`	Target language code	string	`es`
`inputPayload.idp`	Identity provider used	string	`none`
`inputPayload.force_proxy`	Indicates if proxy is forced	boolean	`true`
`inputPayload.timeout`	Request timeout in milliseconds	number	`20000`
`outputPayload`	Response payload returned by the translation provider.
`outputPayload.translations`	List of translated texts	array of strings	`agent ahora ha cerrado esta conversación. Comuníquese con nosotros si necesita ayuda nuevamente.`
`engine`	Translation engine used, for example, `google`, `microsoft`, or `custom`.	string	`custom`
`statusCode`	Status code returned by the translation provider or internal processing layer.	number	`200`
`success`	Indicates whether the translation call succeeded.	boolean	`true`
`batchSize`	Number of items included in the translation request.	number	`1`

Current Limitations

No pagination metadata in the response

The API doesn’t return fields such as total, count, hasMore, or nextOffset. You must manage pagination manually using offset. If the number of matching records exceeds 50, you must manually fetch the next set by passing offset. Examples:

First page: offset=0&limit=50
Second page: offset=50&limit=50
Third page: offset=100&limit=50

Use UTC timestamps for accurate filtering

For accurate filtering, use fromDate and toDate as full UTC timestamps such as 2026-04-27T18:14:06.498Z.

No translation initiation segregation

The response doesn’t indicate where the translation was initiated from. For example, it doesn’t distinguish whether the translation request originated from:

Live Conversation
Monitor Interactions
Other translation-enabled surfaces

So the API returns translation request and response details, but it doesn’t provide a field for translation initiation source.

Message Order Preservation Limitation

The translated messages are accurate. However, the sequence of messages in the request isn’t preserved due to indexing issues.

​Path Parameters

​Sample Request

​Query Parameters

​Sample Response

​Response Parameters

​Current Limitations

​No pagination metadata in the response

​Use UTC timestamps for accurate filtering

​No translation initiation segregation

​Message Order Preservation Limitation

Path Parameters

Sample Request

Query Parameters

Sample Response

Response Parameters

Current Limitations

No pagination metadata in the response

Use UTC timestamps for accurate filtering

No translation initiation segregation

Message Order Preservation Limitation