Firmalar

Firmayı getir

Firma kartının tamamı: kişiler, fırsatlar, son ziyaretler ve denemeler, açık aksiyonlar, teklifler, siparişler, zaman tüneli, rakipler, fiyatlar ve e-posta yazışmaları (threads).

GET/api/v1/customers/{id}

Yetkilendirme

Authorizationheaderzorunlu

Bearer belirteci: API anahtarı (sk_…), OAuth erişim belirteci (mcp_…) ya da mobil oturum (xk_…).

Modül: MüşterilerKapsam: crm.read

Yol parametreleri

idintegerzorunlu

Firma kimliği.

Hatalar

HTTP	error	Anlamı
`404`	`not_found`	Kayıt bulunamadı.

İstek

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

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

Yanıt

{
  "customer": {
    "act": {
      "addr": "İstanbul Organize Sanayi Bölgesi, 3. Cadde No: 25, İstanbul, İstanbul",
      "c": 1,
      "mail": "selin.dogan@alizepaketleme.example",
      "n": "Alize Paketleme San. ve Tic. A.Ş.",
      "tel": "0 (212) 000 55 24",
      "url": "/customers/1",
      "wa": "902120005524",
      "who": "Selin Doğan"
    },
    "active": true,
    "address": "İstanbul Organize Sanayi Bölgesi, 3. Cadde No: 25, İstanbul",
    "at_risk": false,
    "barrier": "",
    "can_edit": true,
    "city": "İstanbul",
    "commit_kg": 1700.0,
    "competitors": [],
    "contacts": [
      {
        "customer": "Alize Paketleme San. ve Tic. A.Ş.",
        "customer_id": 1,
        "department": "Satın Alma",
        "email": "selin.dogan@alizepaketleme.example",
        "id": 1,
        "is_former": false,
        "is_main": true,
        "name": "Selin Doğan",
        "note": "",
        "phone": "0 (212) 000 55 24",
        "rid": "003MaZR2tfJCp1h",
        "title": "Satın Alma Müdürü",
        "wa": "902120005524"
      }
    ],
    "created_at": "2026-03-25T09:00:00",
    "currency": "EUR",
    "currency_default": "",
    "demos": [
      {
        "action_date": "2026-09-02",
        "action_done": true,
        "action_state": "done",
        "customer_id": 1,
        "date": "2026-08-28",
        "id": 1,
        "line": "",
        "next_action": "Fiyat Teklifi",
        "opp_id": 1,
        "product": "PU-SL 200 Solventsiz Laminasyon Yapıştırıcısı",
        "product_id": 1,
        "result": "Başarılı",
        "rid": "a0DZ6tZKUceyZxW",
        "status": "Deneme Gerçekleştirilmiştir",
        "tech_note": "Mürekkep uyumu iyi; şeffaflık beklentiyi karşıladı.",
        "user": "Deniz Aksoy"
      }
    ],
    "events": [
      {
        "badge": null,
        "dot": "#94a3b8",
        "icon": "geo-alt",
        "kind": "plan",
        "note": "",
        "opp_id": null,
        "planned": true,
        "state": null,
        "sub": "periyot 90 gün · son ziyaret 30.09.2026",
        "title": "Planlanan: ziyaret vadesi",
        "url": "",
        "when": "2026-12-29",
        "who": ""
      }
    ],
    "extra_kg": 800.0,
    "id": 1,
    "initials": "AP",
    "last_visit": "2026-09-30",
    "main_contact": {
      "email": "selin.dogan@alizepaketleme.example",
      "name": "Selin Doğan",
      "phone": "0 (212) 000 55 24",
      "wa": "902120005524"
    },
    "mgmt_note": "",
    "mgmt_support": false,
    "name": "Alize Paketleme San. ve Tic. A.Ş.",
    "next_visit_due": "2026-12-29",
    "note": "",
    "offers": [
      {
        "currency": "EUR",
        "date": "2026-09-09",
        "id": 1,
        "is_primary": true,
        "kg": 1500.0,
        "lines": 1,
        "locked": true,
        "monthly_amount": 5880.0,
        "payment_days": 120,
        "pdf_url": "/offers/1/pdf",
        "price": 3.92,
        "product": "PU-SL 200 Solventsiz Laminasyon Yapıştırıcısı",
        "pu": "€/kg",
        "quote_no": "TKL-2026-0001",
        "state": "presented",
        "status": "Kabul",
        "unit": "kg",
        "valid_until": "2026-10-09"
      }
    ],
    "open_actions": [
      {
        "customer": "",
        "customer_id": null,
        "date": "2026-09-30",
        "icon": "⚡",
        "id": 74,
        "key": "visit:74",
        "kind": "visit",
        "label": "Ziyaret Planla",
        "opp": "Mevcut Müşteri — Yenileme · 2026",
        "opp_id": 31,
        "src": "Ziyaret",
        "state": "overdue",
        "url": "/action/visit/74"
      }
    ],
    "open_opps": 1,
    "opps": [
      {
        "bant": 0,
        "base_currency": "EUR",
        "close_date": "2027-03-31",
        "cur_sym": "€",
        "currency": "EUR",
        "customer": "Alize Paketleme San. ve Tic. A.Ş.",
        "customer_city": "İstanbul",
        "customer_id": 1,
        "days_in_stage": 0,
        "detail_status": "",
        "fc": "Omitted",
        "health": null,
        "health_color": null,
        "health_manual": false,
        "health_note": "",
        "id": 44,
        "initials": "AP",
        "is_account": true,
        "is_open": false,
        "last_update": "2026-10-02",
        "lifetime_left": 180,
        "line": "",
        "name": "Müşteri Takibi",
        "next_step": null,
        "offer_price": null,
        "owner": {
          "full_name": "Deniz Aksoy",
          "id": 1,
          "role": "admin",
          "role_label": "Yönetici",
          "username": "admin"
        },
        "payment_days": null,
        "potential_kg": null,
        "prob": 0.0,
        "probability": null,
        "product": "",
        "product_id": null,
        "pu": "€/kg",
        "rid": "006w4ETEfW9soDW",
        "sla_days": null,
        "sla_left": null,
        "source": "",
        "stage": "Account",
        "stage_label": "Müşteri Takibi",
        "start_date": "2026-10-02",
        "trend": "",
        "trend_label": "Otomatik",
        "type": "Müşteri Takibi",
        "unit": "kg",
        "unit_code": "kg",
        "value": 0,
        "value_base": 0,
        "value_short": "0"
      }
    ],
    "orders": [
      {
        "currency": "EUR",
        "date": "2026-10-02",
        "id": 1,
        "kg": 700.0,
        "kind": "İlk Sipariş",
        "note": "",
        "opp_id": 1,
        "payment_days": 120,
        "price": 3.92,
        "product": "PU-SL 200 Solventsiz Laminasyon Yapıştırıcısı",
        "pu": "€/kg",
        "unit": "kg"
      }
    ],
    "our_kg_current": 1600.0,
    "our_kg_target": 2400.0,
    "owner": {
      "full_name": "Deniz Aksoy",
      "id": 1,
      "role": "admin",
      "role_label": "Yönetici",
      "username": "admin"
    },
    "pending_state": "overdue",
    "period": 90,
    "phone": "0 (212) 000 15 65",
    "potential_kg": 8000.0,
    "prices": [
      {
        "currency": "EUR",
        "id": 1,
        "payment_days": 120,
        "price": 3.92,
        "product": "PU-SL 200 Solventsiz Laminasyon Yapıştırıcısı",
        "product_id": 1,
        "pu": "€/kg",
        "source": "TKL-2026-0001 (Win)",
        "valid_until": "2027-10-01"
      }
    ],
    "priority_score": 50.0,
    "rid": "001RBoHIo80N8nR",
    "sector": "Gıda ambalajı",
    "share_current": 20.0,
    "share_start": null,
    "share_target": 30.0,
    "status": "AC",
    "status_label": "Aktif Müşteri",
    "supplier_note": "Distribütör ürünü",
    "threads": [
      {
        "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
      }
    ],
    "threads_n": 1,
    "unit": "kg",
    "visit_overdue_days": -88,
    "visit_period_days": null,
    "visit_postponed_until": null,
    "visit_state": "ok",
    "visits": [
      {
        "action_date": "2026-09-30",
        "action_done": false,
        "action_state": "overdue",
        "contact": "Selin Doğan",
        "customer": "Alize Paketleme San. ve Tic. A.Ş.",
        "customer_id": 1,
        "date": "2026-09-30",
        "id": 74,
        "line": "",
        "next_action": "Ziyaret Planla",
        "note": "Hat 2'de tünelleşme sorunu konuşuldu; solventsiz sisteme geçiş planlıyorlar.",
        "opp": "Mevcut Müşteri — Yenileme · 2026",
        "opp_id": 31,
        "product": "",
        "result": "Teklif istendi",
        "rid": "00U2wBTaDRg4JXL",
        "topic": "Tanışma",
        "type": "Call",
        "user": "Deniz Aksoy"
      }
    ],
    "website": "www.alizepaketleme.example"
  },
  "ok": true
}

Örnek yanıt örnek veriyle çalışan bir v22 kurulumundan alındı; listeler en çok iki öğeyle kısaltıldı.