Workspace

Today

The user's day: today's meetings and actions, overdue items, recently opened records (companies, opportunities, people, leads) and this week's visit / task targets. The mobile home screen is drawn from this response.

GET/api/v1/today

Authorization

Authorizationheaderrequired

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

Scope: crm.read

Request

curl https://ornek.solk.app/api/v1/today \
  -H "Authorization: Bearer $SOLK_API_KEY"

const res = await fetch("https://ornek.solk.app/api/v1/today", {
  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/today",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
)
print(r.json())

Response

{
  "cards": {
    "contacts": {
      "mine": [
        {
          "customer": "Orkide Medikal Ambalaj Ltd. Şti.",
          "customer_id": 30,
          "department": "Üretim",
          "email": "ugur.ozkan@orkidemedikal.example",
          "id": 57,
          "is_former": false,
          "is_main": true,
          "name": "Uğur Özkan",
          "note": "",
          "phone": "0 (262) 000 91 77",
          "rid": "003LlalbBDATepx",
          "title": "Üretim Müdürü",
          "wa": "902620009177"
        }
      ],
      "n": {
        "mine": 57,
        "recent": 0,
        "team": 57
      },
      "recent": [],
      "team": [
        {
          "customer": "Orkide Medikal Ambalaj Ltd. Şti.",
          "customer_id": 30,
          "department": "Üretim",
          "email": "ugur.ozkan@orkidemedikal.example",
          "id": 57,
          "is_former": false,
          "is_main": true,
          "name": "Uğur Özkan",
          "note": "",
          "phone": "0 (262) 000 91 77",
          "rid": "003LlalbBDATepx",
          "title": "Üretim Müdürü",
          "wa": "902620009177"
        }
      ]
    },
    "customers": {
      "mine": [
        {
          "active": true,
          "at_risk": false,
          "city": "Bursa",
          "currency": "EUR",
          "currency_default": "",
          "id": 25,
          "initials": "AE",
          "last_visit": "2026-07-24",
          "main_contact": {
            "email": "kaan.ozkan@akasyaesnek.example",
            "name": "Kaan Özkan",
            "phone": "0 (224) 000 17 41",
            "wa": "902240001741"
          },
          "name": "Akasya Esnek Ambalaj San. ve Tic. A.Ş.",
          "next_visit_due": "2027-01-20",
          "open_opps": 1,
          "owner": {
            "full_name": "Deniz Aksoy",
            "id": 1,
            "role": "admin",
            "role_label": "Yönetici",
            "username": "admin"
          },
          "pending_state": "soon",
          "period": 180,
          "phone": "0 (224) 000 35 36",
          "potential_kg": 40000.0,
          "rid": "001Yk1AKJ1EIEQw",
          "sector": "Esnek ambalaj",
          "status": "Prospect",
          "status_label": "Prospect",
          "unit": "kg",
          "visit_overdue_days": -110,
          "visit_state": "ok"
        }
      ],
      "n": {
        "mine": 30,
        "recent": 0,
        "team": 30
      },
      "recent": [],
      "team": [
        {
          "active": true,
          "at_risk": false,
          "city": "Bursa",
          "currency": "EUR",
          "currency_default": "",
          "id": 25,
          "initials": "AE",
          "last_visit": "2026-07-24",
          "main_contact": {
            "email": "kaan.ozkan@akasyaesnek.example",
            "name": "Kaan Özkan",
            "phone": "0 (224) 000 17 41",
            "wa": "902240001741"
          },
          "name": "Akasya Esnek Ambalaj San. ve Tic. A.Ş.",
          "next_visit_due": "2027-01-20",
          "open_opps": 1,
          "owner": {
            "full_name": "Deniz Aksoy",
            "id": 1,
            "role": "admin",
            "role_label": "Yönetici",
            "username": "admin"
          },
          "pending_state": "soon",
          "period": 180,
          "phone": "0 (224) 000 35 36",
          "potential_kg": 40000.0,
          "rid": "001Yk1AKJ1EIEQw",
          "sector": "Esnek ambalaj",
          "status": "Prospect",
          "status_label": "Prospect",
          "unit": "kg",
          "visit_overdue_days": -110,
          "visit_state": "ok"
        }
      ]
    },
    "leads": {
      "mine": [
        {
          "can_edit": true,
          "city": "Bursa",
          "company": "Işıltı Ambalaj San. Tic. Ltd. Şti.",
          "contact_name": "Mehmet Arslan",
          "created_at": "2026-08-28T14:10:00",
          "customer_id": null,
          "email": "mehmet@isiltiambalajsanti.example",
          "fair": "Ambalaj Fuarı 2026 (örnek)",
          "fair_id": 1,
          "id": 4,
          "initials": "IA",
          "interest": "Soğuk",
          "line": "",
          "next_action": "Numune gönder",
          "next_date": "2026-10-07",
          "note": "Stantta görüşüldü.",
          "opp_id": null,
          "opp_type": "Mevcut Müşteri — Değişim",
          "owner": {
            "full_name": "Deniz Aksoy",
            "id": 1,
            "role": "admin",
            "role_label": "Yönetici",
            "username": "admin"
          },
          "phone": "0 (224) 000 96 45",
          "potential_kg": 6000.0,
          "products": "4",
          "products_text": "",
          "project_note": "",
          "rid": "00QCwrpUC4bpt3E",
          "sector": "Gıda ambalajı",
          "status": "Teklif verildi",
          "status_eff": "Teklif verildi",
          "supplier": "Mevcut tedarikçi (Asya)",
          "task_id": null,
          "timing": "6 ay içinde",
          "title": "Kalite Kontrol Müdürü",
          "unit": "kg",
          "visitor_type": "Potansiyel müşteri",
          "wa": "902240009645",
          "website": ""
        }
      ],
      "n": {
        "mine": 9,
        "recent": 0,
        "team": 3
      },
      "recent": [],
      "team": [
        {
          "can_edit": true,
          "city": "Konya",
          "company": "Alize Ambalaj A.Ş.",
          "contact_name": "Barış Kaya",
          "created_at": "2026-08-25T15:10:00",
          "customer_id": null,
          "email": "baris@alizeambalajas.example",
          "fair": "Ambalaj Fuarı 2026 (örnek)",
          "fair_id": 1,
          "id": 5,
          "initials": "AA",
          "interest": "Sıcak",
          "line": "",
          "next_action": "Teklif gönder",
          "next_date": "2026-10-03",
          "note": "Stantta görüşüldü.",
          "opp_id": null,
          "opp_type": "Yeni Müşteri",
          "owner": {
            "full_name": "Deniz Aksoy",
            "id": 1,
            "role": "admin",
            "role_label": "Yönetici",
            "username": "admin"
          },
          "phone": "0 (332) 000 44 97",
          "potential_kg": 4000.0,
          "products": "5",
          "products_text": "",
          "project_note": "",
          "rid": "00QiUPO55IJhtmL",
          "sector": "Etiket",
          "status": "Yeni",
          "status_eff": "Yeni",
          "supplier": "Mevcut tedarikçi (Asya)",
          "task_id": null,
          "timing": "3 ay içinde",
          "title": "Genel Müdür",
          "unit": "kg",
          "visitor_type": "Potansiyel müşteri",
          "wa": "903320004497",
          "website": ""
        }
      ]
    },
    "opps": {
      "mine": [
        {
          "bant": 4,
          "base_currency": "EUR",
          "close_date": "2026-11-17",
          "cur_sym": "€",
          "currency": "EUR",
          "customer": "Begonya Esnek Ambalaj A.Ş.",
          "customer_city": "Kocaeli",
          "customer_id": 16,
          "days_in_stage": 21,
          "detail_status": "",
          "fc": "Commit",
          "health": {
            "grade": "success",
            "label": "sağlıklı",
            "score": 100
          },
          "health_color": "g",
          "health_manual": false,
          "health_note": "",
          "id": 16,
          "initials": "BE",
          "is_account": false,
          "is_open": true,
          "last_update": "2026-10-02",
          "lifetime_left": 105,
          "line": "",
          "name": "Mevcut Müşteri — Değişim · 2026",
          "next_step": "Vade ve teslim koşullarını görüş",
          "offer_price": 4.08,
          "owner": {
            "full_name": "Deniz Aksoy",
            "id": 1,
            "role": "admin",
            "role_label": "Yönetici",
            "username": "admin"
          },
          "payment_days": 60,
          "potential_kg": 4000.0,
          "prob": 0.75,
          "probability": null,
          "product": "PU-SL 200 Solventsiz Laminasyon Yapıştırıcısı",
          "product_id": 1,
          "pu": "€/kg",
          "rid": "006aJYGE9HUIaM2",
          "sla_days": 30,
          "sla_left": 9,
          "source": "Bayi / distribütör",
          "stage": "Negotiation",
          "stage_label": "Negotiation",
          "start_date": "2026-07-19",
          "trend": "",
          "trend_label": "Otomatik",
          "type": "Mevcut Müşteri — Değişim",
          "unit": "kg",
          "unit_code": "kg",
          "value": 195840.0,
          "value_base": 195840.0,
          "value_short": "196K"
        }
      ],
      "n": {
        "mine": 28,
        "recent": 0,
        "team": 28
      },
      "recent": [],
      "team": [
        {
          "bant": 4,
          "base_currency": "EUR",
          "close_date": "2026-11-17",
          "cur_sym": "€",
          "currency": "EUR",
          "customer": "Begonya Esnek Ambalaj A.Ş.",
          "customer_city": "Kocaeli",
          "customer_id": 16,
          "days_in_stage": 21,
          "detail_status": "",
          "fc": "Commit",
          "health": {
            "grade": "success",
            "label": "sağlıklı",
            "score": 100
          },
          "health_color": "g",
          "health_manual": false,
          "health_note": "",
          "id": 16,
          "initials": "BE",
          "is_account": false,
          "is_open": true,
          "last_update": "2026-10-02",
          "lifetime_left": 105,
          "line": "",
          "name": "Mevcut Müşteri — Değişim · 2026",
          "next_step": "Vade ve teslim koşullarını görüş",
          "offer_price": 4.08,
          "owner": {
            "full_name": "Deniz Aksoy",
            "id": 1,
            "role": "admin",
            "role_label": "Yönetici",
            "username": "admin"
          },
          "payment_days": 60,
          "potential_kg": 4000.0,
          "prob": 0.75,
          "probability": null,
          "product": "PU-SL 200 Solventsiz Laminasyon Yapıştırıcısı",
          "product_id": 1,
          "pu": "€/kg",
          "rid": "006aJYGE9HUIaM2",
          "sla_days": 30,
          "sla_left": 9,
          "source": "Bayi / distribütör",
          "stage": "Negotiation",
          "stage_label": "Negotiation",
          "start_date": "2026-07-19",
          "trend": "",
          "trend_label": "Otomatik",
          "type": "Mevcut Müşteri — Değişim",
          "unit": "kg",
          "unit_code": "kg",
          "value": 195840.0,
          "value_base": 195840.0,
          "value_short": "196K"
        }
      ]
    }
  },
  "day_label": "Cuma, 2 Ekim 2026",
  "events": [
    {
      "act": {
        "addr": "Kayseri Organize Sanayi Bölgesi, 1. Cadde No: 46, Kayseri, Kayseri",
        "c": 4,
        "mail": "nazli.aydin@ihlamurmatbaacilik.example",
        "n": "Ihlamur Matbaacılık A.Ş.",
        "tel": "0 (352) 000 57 99",
        "url": "/customers/4",
        "wa": "903520005799",
        "who": "Nazlı Aydın"
      },
      "customer_id": 4,
      "date": "2026-10-02",
      "kind": "opp",
      "sub": "Mevcut Müşteri — Ek Satış · 2026 · Qualify",
      "time": null,
      "title": "Ihlamur Matbaacılık A.Ş. · sonraki adım",
      "url": "/opportunities/34"
    },
    {
      "act": {
        "addr": "Sakarya Organize Sanayi Bölgesi, 4. Cadde No: 54, Sakarya, Sakarya",
        "c": 10,
        "mail": "murat.cetin@reyhanpaketleme.example",
        "n": "Reyhan Paketleme Ltd. Şti.",
        "tel": "0 (264) 000 63 67",
        "url": "/customers/10",
        "wa": "902640006367",
        "who": "Murat Çetin"
      },
      "customer_id": 10,
      "date": "2026-10-02",
      "kind": "opp",
      "sub": "Mevcut Müşteri — Ek Satış · 2026 · Expect to Close",
      "time": null,
      "title": "Reyhan Paketleme Ltd. Şti. · sonraki adım",
      "url": "/opportunities/10"
    }
  ],
  "focus": [
    {
      "cls": "bad",
      "text": "9 gecikmiş aksiyon"
    },
    {
      "cls": "warn",
      "text": "3 aksiyon bugün"
    }
  ],
  "greeting": "İyi akşamlar",
  "ok": true,
  "today": "2026-10-02",
  "todos": {
    "all": [
      {
        "customer": "Lotus Medikal Ambalaj San. Tic. Ltd. Şti.",
        "customer_id": 3,
        "date": "2026-09-26",
        "icon": "📋",
        "id": 1,
        "key": "task:1",
        "kind": "task",
        "label": "Numune sonucu için ara",
        "opp": "Yeni Müşteri · 2026",
        "opp_id": 33,
        "src": "Görev",
        "state": "overdue",
        "url": "/action/task/1"
      }
    ],
    "overdue": [
      {
        "customer": "Lotus Medikal Ambalaj San. Tic. Ltd. Şti.",
        "customer_id": 3,
        "date": "2026-09-26",
        "icon": "📋",
        "id": 1,
        "key": "task:1",
        "kind": "task",
        "label": "Numune sonucu için ara",
        "opp": "Yeni Müşteri · 2026",
        "opp_id": 33,
        "src": "Görev",
        "state": "overdue",
        "url": "/action/task/1"
      }
    ],
    "today": [
      {
        "customer": "Işıltı Film A.Ş.",
        "customer_id": 8,
        "date": "2026-10-02",
        "icon": "📋",
        "id": 2,
        "key": "task:2",
        "kind": "task",
        "label": "Teklif revizyonunu gönder",
        "opp": "",
        "opp_id": null,
        "src": "Görev",
        "state": "soon",
        "url": "/action/task/2"
      }
    ]
  },
  "unread": 0,
  "week": {
    "demos": 1,
    "f2f": 3,
    "f2f_target": 6,
    "label": "28 Eyl – 4 Eki",
    "sub_fresh": false,
    "sub_week": null,
    "tasks_done": 2,
    "tasks_target": 12,
    "visit_target": 10,
    "visits": 7
  }
}

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