Get Conversation Logs

curl --request POST \
  --url https://api.inya.ai/platform/v1/conversations/logs \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "pageNo": 1,
  "pageSize": 10
}
'

import requests

url = "https://api.inya.ai/platform/v1/conversations/logs"

payload = {
    "pageNo": 1,
    "pageSize": 10
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({pageNo: 1, pageSize: 10})
};

fetch('https://api.inya.ai/platform/v1/conversations/logs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "status": "success",
  "requestId": "<string>",
  "message": "Conversations retrieved successfully",
  "response": {
    "pageNo": 123,
    "pageSize": 123,
    "totalCount": 123,
    "totalPages": 123,
    "data": [
      {
        "conversationId": "conv_123",
        "userId": "user_123",
        "botId": "fb79920229d144608ebf665a10e50275",
        "botName": "Support Agent",
        "startTime": 123,
        "endTime": 123,
        "name": "Hello, how are you?",
        "transcript": [
          {
            "role": "user",
            "content": "Hello, how are you?"
          },
          {
            "role": "assistant",
            "content": "I'm good, thank you!"
          }
        ]
      }
    ]
  }
}

{
  "status": "error",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "<string>"
}

{
  "status": "error",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "<string>"
}

POST

conversations

logs

Get Conversation Logs

curl --request POST \
  --url https://api.inya.ai/platform/v1/conversations/logs \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "pageNo": 1,
  "pageSize": 10
}
'

import requests

url = "https://api.inya.ai/platform/v1/conversations/logs"

payload = {
    "pageNo": 1,
    "pageSize": 10
}
headers = {
    "x-api-key": "<api-key>",
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

print(response.text)

const options = {
  method: 'POST',
  headers: {'x-api-key': '<api-key>', 'Content-Type': 'application/json'},
  body: JSON.stringify({pageNo: 1, pageSize: 10})
};

fetch('https://api.inya.ai/platform/v1/conversations/logs', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

{
  "status": "success",
  "requestId": "<string>",
  "message": "Conversations retrieved successfully",
  "response": {
    "pageNo": 123,
    "pageSize": 123,
    "totalCount": 123,
    "totalPages": 123,
    "data": [
      {
        "conversationId": "conv_123",
        "userId": "user_123",
        "botId": "fb79920229d144608ebf665a10e50275",
        "botName": "Support Agent",
        "startTime": 123,
        "endTime": 123,
        "name": "Hello, how are you?",
        "transcript": [
          {
            "role": "user",
            "content": "Hello, how are you?"
          },
          {
            "role": "assistant",
            "content": "I'm good, thank you!"
          }
        ]
      }
    ]
  }
}

{
  "status": "error",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "<string>"
}

{
  "status": "error",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "<string>"
}

Overview

Retrieve a paginated list of conversation records across your organization. Supports filtering by date range, agent, environment, and call status. Use this endpoint to review conversation history, monitor call completion rates, and export data for analysis.

Required Permission

conversations

Query Parameters

Name	Type	Required	Description
`botId`	string	No	Filter logs to a specific agent.
`environment`	string	No	Filter by environment: `development`, `staging`, or `production`.

For some API key types, environment=development must be passed explicitly. Omitting it may return a 403 error. If you receive a permission error with no other cause, add ?environment=development to your request.

Request Body

Field	Type	Required	Description
`pageNo`	integer	Yes	Page number to retrieve. Must be `1` or higher. Sending `0` returns HTTP 200 with an empty `data` field rather than an error.
`pageSize`	integer	Yes	Number of conversations per page. Recommended maximum: `100`.
`searchTerm`	string	No	Free-text search across conversation records.
`filter.botId`	string	No	Filter by agent ID.
`filter.startDate`	string	No	ISO 8601 start date/time (e.g. `"2026-01-01T00:00:00.000Z"`).
`filter.endDate`	string	No	ISO 8601 end date/time (e.g. `"2026-07-21T23:59:59.999Z"`).
`filter.callStatus`	string \| string[]	No	Filter by call status. Accepted values: `completed`, `failed`, etc.

Example cURL

Basic Pagination

curl -X POST "https://api.inya.ai/platform/v1/conversations/logs?environment=development" \
  -H "x-api-key: <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "pageNo": 1,
    "pageSize": 10
  }'

Filter by Agent and Date Range

curl -X POST "https://api.inya.ai/platform/v1/conversations/logs?botId=fb79920229d144608ebf665a10e50275" \
  -H "x-api-key: <your_api_key>" \
  -H "Content-Type: application/json" \
  -d '{
    "filter": {
      "startDate": "2026-07-01T00:00:00.000Z",
      "endDate": "2026-07-15T23:59:59.999Z"
    },
    "pageNo": 1,
    "pageSize": 10
  }'

Response

Success (200)

{
  "status": "success",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "Conversations retrieved successfully",
  "response": {
    "pageNo": 1,
    "pageSize": 10,
    "totalCount": 150,
    "totalPages": 15,
    "data": [
      {
        "conversationId": "conv_abc123",
        "userId": "user_123",
        "botId": "58f010d9e797494aae193fdc537a7c33",
        "botName": "Support Agent",
        "startTime": 1752918000,
        "endTime": 1752918600,
        "name": "Jane Doe",
        "transcript": []
      }
    ]
  }
}

Response Fields

Field	Type	Description
`pageNo`	integer	Current page number.
`pageSize`	integer	Number of results per page.
`totalCount`	integer	Total number of conversations matching the applied filters.
`totalPages`	integer	Total number of pages available.
`data[].conversationId`	string	Unique conversation identifier.
`data[].botId`	string	Agent that handled this conversation.
`data[].botName`	string	Display name of the agent.
`data[].startTime`	integer	Unix timestamp (seconds) of call start.
`data[].endTime`	integer	Unix timestamp (seconds) of call end.
`data[].name`	string	Name of the person who was called.
`data[].transcript`	array	Utterance records for this conversation. May be empty in the list view.

Error Responses

403 Forbidden - Insufficient permissions

{
  "status": "failure",
  "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "message": "User does not have access to conversation logs"
}

Use Cases

Reviewing conversation history for quality assurance
Searching for specific conversations by keyword or caller name
Exporting conversation data for business intelligence pipelines
Monitoring call completion rates over time

Use filter.startDate and filter.endDate together to narrow results to a specific reporting period. For large date ranges, combine with pageSize: 100 and iterate through all pages.

Timestamps in the response are Unix timestamps (seconds since epoch). Convert them to your local timezone for display purposes.

Save the requestId from every response. You will need it if you contact Inya support to trace a specific request.

Authorizations

x-api-key

string

header

required

API key with 'conversations' permission

Query Parameters

botId

string

Filter logs to a specific agent.

environment

enum<string>

Filter by environment.

Available options:

development,

staging,

production

Body

application/json

pageNo

integer

required

Page number to retrieve.

Required range: x >= 1

Example:

1

pageSize

integer

required

Number of conversations per page (1–100).

Required range: 1 <= x <= 100

Example:

10

searchTerm

string

Free-text search across conversation records.

filter

object

Show child attributes

Response

Conversations retrieved successfully

status

string

Example:

"success"

requestId

string

message

string

Example:

"Conversations retrieved successfully"

response

object

Show child attributes

Getting Started

Agents API

Conversations API

Agent Config API

Agent FAQ API

Chat SDK API

Reference

Get Conversation Logs

Overview

Required Permission

Query Parameters

Request Body

Example cURL

Filter by Agent and Date Range

Response

Success (200)

Response Fields

Error Responses

Use Cases

Authorizations

Query Parameters

Body

Response

​Overview

​Required Permission

​Query Parameters

​Request Body

​Example cURL

​Basic Pagination

​Filter by Agent and Date Range

​Response

​Success (200)

​Response Fields

​Error Responses

​Use Cases

Authorizations

Query Parameters

Body

Response

Overview

Required Permission

Query Parameters

Request Body

Example cURL

Basic Pagination

Filter by Agent and Date Range

Response

Success (200)

Response Fields

Error Responses

Use Cases