List notifications
The user's latest notifications (newest first) and the unread count. Each row: kind (type — mention, comment, task, assign, approval, deal, ticket, email, call, summary, flow, support — a reply from Solk support, system), kind_label, title (short title, e.g. Quote awaits your approval), body (description, e.g. T-2026-0044 · Kuzey Plastik A.Ş. · 14% discount), message (the old one-line text), link, is_read, created_at and nav (the app screen to open, or null). With v=2 also actor (the person whose action caused the notification: id, name, initials, color, photo) and alt (the related record for a link the app has no screen for — e.g. a support ticket → its company: screen, id, label, name); the response adds last_id, more (older ones exist), filter, filters. System notifications (licence, usage invoice, background jobs) only come with filter=system (admins) and are not counted in unread. Without v the old shape: no system notifications, and a link the app has no screen for is empty (link: "").
Authorization
Authorizationheaderrequiredcrm.readQuery parameters
vstringoptional2 = the new shape with title, description, person and related record.filterstringoptionalv=2: filter.allunreadmentionassignapprovalsystemsinceintegeroptionalbeforeintegeroptionallimitintegeroptionalcurl "https://ornek.solk.app/api/v1/notifications?v=2&limit=5" \
-H "Authorization: Bearer $SOLK_API_KEY"const res = await fetch("https://ornek.solk.app/api/v1/notifications?v=2&limit=5", {
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/notifications",
headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
params={"v": "2", "limit": 5},
)
print(r.json()){
"filter": "all",
"filters": [
{
"k": "all",
"label": "Tümü"
},
{
"k": "unread",
"label": "Okunmamış"
}
],
"last_id": 3,
"more": false,
"ok": true,
"rows": [
{
"actor": {
"color": "#b95ccd",
"id": 2,
"initials": "AD",
"name": "Ayşe Demir",
"photo": null
},
"alt": null,
"body": "@Deniz yarın fiyatı konuşalım, iskonto %12'yi geçmesin.",
"created_at": "2026-10-15T10:59:07",
"id": 3,
"is_read": false,
"kind": "mention",
"kind_label": "Bahsetme",
"link": "/customers/1?note=1#cNotes",
"message": "Ayşe Demir sizden bahsetti: @Deniz yarın fiyatı konuşalım, iskonto %12'yi geçmesin.",
"nav": {
"id": 1,
"screen": "customer"
},
"title": "Ayşe Demir sizden bahsetti"
},
{
"actor": {
"color": "#b95ccd",
"id": 2,
"initials": "AD",
"name": "Ayşe Demir",
"photo": null
},
"alt": null,
"body": "Yeni Müşteri · 2026 · Alize Paketleme San. ve Tic. A.Ş.",
"created_at": "2026-10-15T10:42:07",
"id": 2,
"is_read": false,
"kind": "assign",
"kind_label": "Devir",
"link": "/opportunities/1",
"message": "Size devredilen fırsat: Alize Paketleme San. ve Tic. A.Ş. · Yeni Müşteri · 2026",
"nav": {
"id": 1,
"screen": "opp"
},
"title": "Fırsat size devredildi"
}
],
"unread": 3
}Example responses were captured from a v98 installation running sample data; lists are shortened to two items.