View as Markdown Open in Claude

List threads

E-mail threads either for one record (kind + id) or the inbox (filter, q). Content follows the user's permission to see it.

GET/api/v1/threads

Authorization

Authorizationheaderrequired

Bearer token: API key (sk_…), OAuth access token (mcp_…) or mobile session (xk_…).

Scope: crm.read

Query parameters

kindstringoptional

Record type.

Valuescustomeroppvisitdemotaskofferticketcontract

idintegeroptional

Record id.

filterstringoptional

waiting awaiting reply, replied, mine.

Valuesallwaitingrepliedmine

qstringoptional

Subject or address contains.

Request

curl "https://ornek.solk.app/api/v1/threads?filter=all" \
  -H "Authorization: Bearer $SOLK_API_KEY"

const res = await fetch("https://ornek.solk.app/api/v1/threads?filter=all", {
  headers: {
    Authorization: `Bearer ${process.env.SOLK_API_KEY}`,
  },
});
const data = await res.json();

import os, requests

r = requests.get(
    "https://ornek.solk.app/api/v1/threads",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    params={"filter": "all"},
)
print(r.json())

Response

{
  "items": [
    {
      "customer": "Alize Paketleme San. ve Tic. A.Ş.",
      "customer_id": 1,
      "id": 1,
      "last_at": "2026-10-01T15:06:59",
      "last_dir": "out",
      "n": 2,
      "opp": "Mevcut Müşteri — Yenileme · 2026",
      "opp_how": "single",
      "opp_id": 31,
      "opp_note": "firmanın tek açık projesi",
      "peer": "selin.dogan@alizepaketleme.example",
      "subject": "Numune ve fiyat teklifi",
      "suggested": false,
      "waiting": false
    }
  ],
  "mailbox": {
    "connected": true,
    "email": "deniz@ornekkimya.com.tr",
    "error": "",
    "signature": false,
    "status": "ok"
  },
  "ok": true,
  "total": 1
}

Example responses were captured from a v22 installation running sample data; lists are shortened to two items.