Saltar al contenido principal
GET
/
v1
/
thread
/
{threadId}
curl -X GET "https://api.contactship.ai/v1/thread/thr-b2c3d4e5-f6a7-8901-bcde-f12345678901" \
  -H "x-api-key: your-api-key"

{
  "id": "thr-b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "channel_id": "chn_y0xspd9p1v7vla6wkwc2z01u",
  "channel_type": "WABA",
  "contact_id": "c1d2e3f4-a5b6-7890-cdef-123456789012",
  "organization_id": "org-f1e2d3c4-b5a6-7890-1234-567890abcdef",
  "status": "open",
  "assignee": null,
  "assignee_type": null,
  "created_at": "2026-04-06T15:00:00Z",
  "updated_at": "2026-04-06T15:05:00Z"
}
Returns the details of a specific conversation thread, including its channel, contact, status, and assignee.

​
Headers

​
x-api-key
string
requerido
Your API key for authentication.

​
Path Parameters

​
threadId
string
requerido
The UUID of the thread to retrieve.

​
Response

​
id
string
Unique identifier of the thread (UUID).
​
channel_id
string
UUID of the channel this thread belongs to.
​
channel_type
string
Type of the channel (e.g. WABA, INSTAGRAM).
​
contact_id
string
UUID of the contact in this thread.
​
organization_id
string
UUID of the organization that owns this thread.
​
status
string
Thread status (e.g. open, closed).
​
assignee
string
UUID of the user or agent currently assigned to this thread.
​
assignee_type
string
Type of the assignee: user or agent.
​
created_at
string
Timestamp when the thread was created (ISO 8601).
​
updated_at
string
Timestamp of the last update (ISO 8601).

​
Error Codes

  • 401 Unauthorized — Invalid or missing API key
  • 404 Not Found — Thread not found or does not belong to your organization
  • 500 Internal Server Error — Server-side error

​
Code Examples

curl -X GET "https://api.contactship.ai/v1/thread/thr-b2c3d4e5-f6a7-8901-bcde-f12345678901" \
  -H "x-api-key: your-api-key"

{
  "id": "thr-b2c3d4e5-f6a7-8901-bcde-f12345678901",
  "channel_id": "chn_y0xspd9p1v7vla6wkwc2z01u",
  "channel_type": "WABA",
  "contact_id": "c1d2e3f4-a5b6-7890-cdef-123456789012",
  "organization_id": "org-f1e2d3c4-b5a6-7890-1234-567890abcdef",
  "status": "open",
  "assignee": null,
  "assignee_type": null,
  "created_at": "2026-04-06T15:00:00Z",
  "updated_at": "2026-04-06T15:05:00Z"
}