SparrowDesk
ConversationsIdReplies

List all replies for a conversation

GET
/conversations/{id}/replies

Authorization

AuthorizationBearer <token>

In: header

Path Parameters

idinteger

id of the conversation

Query Parameters

starting_after?string

Cursor for pagination

per_page?integer

Number of replies per page (1-100, default 25)

Range1 <= value <= 100
type?string

Filter by reply type (if not provided, returns all types)

Value in"INTERNAL_NOTE" | "REPLY"
sort_order?string

Sort order by sent_at (default desc)

Value in"asc" | "desc"

Response Body

application/json

application/json

application/json

application/json

curl -X GET "https://app.sparrowdesk.com/v1/conversations/123/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": 25,
    "next_cursor": "eyJpZCI6Njc4OTIsImNyZWF0ZWRfYXQiOjE2NzI1MzEyMDB9",
    "next_url": "https://api.sparrowdesk.com/conversations/123/replies?per_page=25&starting_after=eyJpZCI6Njc4OTIsImNyZWF0ZWRfYXQiOjE2NzI1MzEyMDB9"
  },
  "total_count": 156
}
{
  "error": {
    "message": "Invalid query parameters"
  }
}
{
  "error": {
    "message": "Conversation not found"
  }
}
{
  "error": {
    "message": "Error retrieving conversation replies"
  }
}