Skip to main content
GET
/
conversations
/
{id}
Retrieve a conversation
curl --request GET \
  --url https://api.getfernand.com/conversations/{id} \
  --header 'X-API-Key: <api-key>'
{
  "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"
}
Fetches the full details of a specific conversation. Returns a 404 error if the conversation is not found.

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.

Path Parameters

​
id
integer<int64>
required

Unique identifier of the conversation to retrieve.

Response

Conversation retrieved successfully.

​
id
integer<int64>
required

Unique identifier for the conversation

Example:

12345

​
contact_id
integer<int64>
required

ID of the primary contact who initiated the conversation

Example:

789

​
subject
string
required

Subject line of the conversation, derived from the first message or manually set

Maximum string length: 250
Example:

"Question about billing"

​
status
enum<string>
required

Current status of the conversation

Available options:
OPENED,
CLOSED,
SPAM,
SNOOZED
Example:

"OPENED"

​
last_update
string<date-time>
required

ISO 8601 timestamp of the last incoming message in the conversation

Example:

"2026-01-21T14:30:00Z"

​
tags
integer<int32>[]
required

Array of tag IDs associated with this conversation

Example:
[1, 5, 12]
​
recipients
object[]
required

Array of recipients in the conversation (to, cc, bcc)

​
agent_id
integer<int64> | null

ID of the agent assigned to this conversation, or null if unassigned

Example:

42

​
channel_id
integer<int64> | null

ID of the channel through which this conversation is conducted

Example:

1

​
snooze_until
string<date-time> | null

ISO 8601 timestamp indicating when a snoozed conversation should reappear, or null if not snoozed

Example:

"2026-01-22T09:00:00Z"

​
cursor
string | null

Pagination cursor for retrieving the next page of conversations in a list

Example:

"cur_1234567890"