GET
/
api
/
v1
/
agents
/
{agentId}
/
conversations
curl --request GET \
  --url https://api.play.ai/api/v1/agents/{agentId}/conversations \
  --header 'AUTHORIZATION: <api-key>' \
  --header 'X-USER-ID: <api-key>'
[
  {
    "id": "tIKQo8GMvOZyGx0Wm2RT",
    "source": "web",
    "callerEmail": "test@gmail.com",
    "startedAt": "2024-06-04T15:13:53.687Z",
    "endedAt": "2024-06-04T15:18:54.687Z",
    "durationInSeconds": 301
  }
]

Retrieve all information about an agent’s conversations.

​
Response Headers for Pagination

Header NameTypeDescription
X-Page-SizeintegerThe number of items per page.
X-Start-AfterstringThe ID of the last item on the previous page.
X-Next-Start-AfterstringThe ID of the last item on the current page.
X-Total-CountintegerThe total number of items.

These headers are included in the response to help manage pagination when retrieving conversations for a specific agent.

Authorizations

​
AUTHORIZATION
string
header
required

API key required for this endpoint. Use Bearer YOUR_SECRET_API_KEY. Get your key from https://play.ai/developers.

​
X-USER-ID
string
header
required

User ID required for this endpoint. Get it from https://play.ai/developers.

Headers

​
accept
enum<string>
Available options:
application/json

Path Parameters

​
agentId
string
required

The agent's ID.

Query Parameters

​
pageSize
integer
default:
50

The number of items to return per page.

​
startAfter
string

The conversation ID to start after.

Response

200 - application/json
Conversations retrieved.
​
id
string
​
source
string
​
callerEmail
string
​
startedAt
string
​
endedAt
string
​
durationInSeconds
integer