SparrowDesk
Conversations

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.

GET
/conversations/with-replies
AuthorizationBearer <token>

In: header

Query Parameters

starting_after?string|null

Cursor for conversation list pagination

per_page?integer

Conversations per page (1–20, default 20)

Range1 <= value <= 20
replies_per_page?integer

Replies per conversation (1–50, default 50)

Range1 <= value <= 50
replies_sort_order?string

Reply list sort by sent_at (default desc)

Value in"asc" | "desc"
type?string

Filter replies by type

Value in"INTERNAL_NOTE" | "REPLY"
status?array<string>
priority?array<string>
assigned_to_member_id?array<integer>
assigned_to_team_id?array<integer>
brand_id?array<integer>
requested_by_id?integer
handled_by_ai_agent?string

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.

Value intrue | false
search?string

Search by subject, description, replies, or conversation ID. Use quotes for exact phrases.

Lengthlength <= 250
sort_by?string
Value in"created_at" | "updated_at"
sort_order?string

Sort order for the conversation list

Value in"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"
  }
}