Skip to main content
GET
/
conversations
List conversations
curl --request GET \
  --url https://api.getfernand.com/conversations \
  --header 'X-API-Key: <api-key>'
{
  "data": [
    {
      "id": 12345,
      "contact_id": 789,
      "subject": "Question about billing",
      "status": "OPENED",
      "last_update": "2026-01-21T14:30:00Z",
      "tags": [
        1,
        5,
        12
      ],
      "recipients": [
        {
          "id": 12345,
          "contact_id": 789,
          "kind": "cc",
          "conversation_id": 456
        }
      ],
      "agent_id": 42,
      "channel_id": 1,
      "snooze_until": "2026-01-22T09:00:00Z",
      "cursor": "cur_1234567890"
    }
  ],
  "cursor": "<string>"
}
Retrieves a paginated list of conversations for the authenticated organization. Supports filtering by status, agent assignment, tags, and full-text search. Results can be ordered by priority, date, or longest wait time. Pagination is cursor-based for efficient traversal of large datasets.

Authorizations

​
X-API-Key
string
header
required

Authenticate your account by including your secret key in API requests. You can manage your API keys in the Dashboard.

Authentication to the API is performed by using the HTTP Header X-API-Key.

Query Parameters

​
limit
integer
default:25

Maximum number of conversations to return per page.

Required range: 3 <= x <= 250
​
search
string

Search query string. Supports filtering by status, agent, tags, and keywords. Examples:

  • "status:opened" - Filter by status (opened, closed, spam, snoozed)
  • "assigned:jared@piedpiper.com" - Filter by agent email
  • "unassigned:true" - Show only unassigned conversations
  • "tag:urgent" - Filter by tag
  • "keyword search" - Full-text search in conversation content
​
cursor
string

Pagination cursor from the previous response to fetch the next page.

​
order
enum<string>
default:priority

Sort order for conversations (priority, oldest, newest, or longest).

Available options:
priority,
oldest,
newest,
longest

Response

List of conversations retrieved successfully.

​
data
object[]
​
cursor
string | null

Cursor for fetching the next page, or null if no more results.