curl --request GET \
--url https://api.formbharo.artpark.ai/api/v1/agents/{agent_id}/conversationsimport requests
url = "https://api.formbharo.artpark.ai/api/v1/agents/{agent_id}/conversations"
response = requests.get(url)
print(response.text)[
{
"conversation_id": "<string>",
"filled_fields": 123,
"form_data": {},
"form_status": {},
"has_events": true,
"has_log": true,
"has_metrics": true,
"has_recording": true,
"is_ended": true,
"status": "complete",
"total_fields": 123,
"caller_number": "<string>",
"created_at": 123,
"has_transcript": true,
"source": "<string>",
"transcript": [
{}
]
}
]{
"error": "<string>"
}{
"error": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}List Conversations
Return an agent’s conversations: form data and recording availability, newest first.
Add limit or cursor to page. Set include_transcript=true to
include each row’s transcript (off by default); when off, transcript
and has_transcript are absent from the row, not empty.
curl --request GET \
--url https://api.formbharo.artpark.ai/api/v1/agents/{agent_id}/conversationsimport requests
url = "https://api.formbharo.artpark.ai/api/v1/agents/{agent_id}/conversations"
response = requests.get(url)
print(response.text)[
{
"conversation_id": "<string>",
"filled_fields": 123,
"form_data": {},
"form_status": {},
"has_events": true,
"has_log": true,
"has_metrics": true,
"has_recording": true,
"is_ended": true,
"status": "complete",
"total_fields": 123,
"caller_number": "<string>",
"created_at": 123,
"has_transcript": true,
"source": "<string>",
"transcript": [
{}
]
}
]{
"error": "<string>"
}{
"error": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Path Parameters
Query Parameters
Maximum conversations to return. Sending this switches the response to the paged object shape.
1 <= x <= 200Where to resume from: the next_cursor of the previous page. Sending this switches the response to the paged object shape.
x >= 0Only conversations created at or after this unix timestamp. Note: created_at is the last time the call's answers were written, not when the call happened, so a call edited later moves.
Only conversations created at or before this unix timestamp. Note: created_at is the last time the call's answers were written, not when the call happened, so a call edited later moves.
Only conversations with this status.
complete, screened_out, failed, in_progress, not_connected Only conversations from this source (e.g. twilio, exotel).
Include each call's transcript in its row. Off by default; then transcript and has_transcript are absent, not empty.
Response
Successful Response
- ConversationSummary · object[]
- ConversationPage · object
One row of a conversation list.
transcript and has_transcript are both absent unless the request
passed include_transcript=true.
has_recording, has_events, has_log and has_metrics say
whether the call has ended, not whether each file is there. The
per-conversation routes answer 404 when a specific file is not there.
Cost, duration and latency figures are in the analytics numbers, not here.
complete, screened_out, failed, in_progress, not_connected