List all conversations with replies
Conversation list uses the same filters and `starting_after` cursor as GET /conversations (`per_page` max 20). Root `pages` / `total_count` apply to conversations only. Each row includes `replies` with the same shape as GET /conversations/{id}/replies (`data`, `pages`, `total_count`). Use `replies_per_page` (max 50), `replies_sort_order`, and `type` for the embedded reply page. For more replies on a row, call GET /conversations/{id}/replies with `starting_after` = `replies.pages.next_cursor`, or follow `replies.pages.next_url` when returned.
In: header
Query Parameters
Cursor for conversation list pagination
Conversations per page (1–20, default 20)
1 <= value <= 20Replies per conversation (1–50, default 50)
1 <= value <= 50Reply list sort by sent_at (default desc)
"asc" | "desc"Filter replies by type
"INTERNAL_NOTE" | "REPLY"Same as GET /conversations handled_by_ai_agent. Omitted — no filter by AI handling. true — only conversations assigned to an AI agent.
false — conversations handed off for human help, or where the assignee is not an AI agent.
true | falseSearch by subject, description, replies, or conversation ID. Use quotes for exact phrases.
length <= 250"created_at" | "updated_at"Sort order for the conversation list
"asc" | "desc"Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://app.sparrowdesk.com/v1/conversations/with-replies"{
"data": [
{
"id": 12345,
"brand": "Support Brand",
"brand_id": 12345,
"source": "Mail",
"status": "Open",
"priority": "High",
"created_at": 1672531200,
"first_response_time": 1672534800,
"resolution_time": null,
"due": 1672617600,
"first_response_due": 1672538400,
"requested_by_email": "[email protected]",
"requested_by_phone": "+1415555267",
"requested_by_id": 67890,
"assigned_to_member_id": 123,
"assigned_to_team_id": 456,
"last_updated_at": 1672535400,
"subject": "Payment issue with order #12345",
"description_html": "<p>I'm having trouble with my payment...</p>",
"description_text": "I'm having trouble with my payment...",
"attachments": [
"https://cdn.example.com/receipt.pdf"
],
"tags": [
{
"id": 1,
"label": "billing"
}
],
"custom_fields": [
{
"id": 9250,
"value": "ORD-12345",
"option_ids": [
7790,
7791
]
}
],
"csat": {
"score": 4,
"sentiment": "positive",
"feedback": "Great support experience!",
"scale": 5
},
"customer_sentiment": "NEGATIVE",
"properties": {
"request_language": "English",
"browser_timezone": "Asia/Calcutta",
"browser": "Chrome",
"device": "mac OS 10.15.7",
"ip_address": "192.168.1.1",
"country": "India",
"region": "Tamil Nadu > Chennai",
"referral_url": "https://example.com/pricing",
"utm_source": "string",
"utm_medium": "string",
"utm_campaign": "string",
"utm_content": "string",
"utm_term": "string"
},
"replies": {
"data": [
{
"id": "67890",
"type": "REPLY",
"body_html": "<p>Thank you for contacting us.</p>",
"body_text": "Thank you for contacting us.",
"attachments": [],
"author": {
"id": 123,
"name": "Sarah Johnson",
"email": "[email protected]",
"phone": null,
"type": "agent"
},
"sent_at": 1672534800,
"conversation_id": 789,
"brand_id": 123,
"account_id": 456
}
],
"pages": {
"per_page": 50,
"next_cursor": "string",
"next_url": "string"
},
"total_count": 2
}
}
],
"pages": {
"per_page": 20,
"next_cursor": "string",
"next_url": "string"
},
"total_count": 100
}{
"error": {
"message": "string"
}
}{
"message": "Unauthorized"
}{
"error": {
"message": "string"
}
}{
"error": {
"message": "string"
}
}{
"name": "RateLimitExceeded",
"message": "Rate limit exceeded for: APIS_PER_MINUTE",
"code": 429,
"details": [
{
"name": "APIS_PER_MINUTE",
"quota": 0,
"count": 0,
"remaining": 0
}
]
}{
"error": {
"message": "string"
}
}