Opportunities

Get an opportunity

The full opportunity: stage, value, probability, health, checklist steps, BANT, stage-gate problems (gate_problems), visits, trials, offers, orders, tasks, stage history, notes and e-mail threads.

GET/api/v1/opportunities/{id}

Authorization

Authorizationheaderrequired
Bearer token: API key (sk_…), OAuth access token (mcp_…) or mobile session (xk_…).
Module: OpportunitiesScope: crm.read

Path parameters

idintegerrequired
Opportunity id.

Errors

HTTPerrorMeaning
404not_foundRecord not found.
Request
curl https://ornek.solk.app/api/v1/opportunities/31 \
  -H "Authorization: Bearer $SOLK_API_KEY"
Response
{
  "ok": true,
  "opp": {
    "bant": 1,
    "bant_a": true,
    "bant_b": false,
    "bant_n": false,
    "bant_t": false,
    "base_currency": "EUR",
    "can_edit": true,
    "can_revive": false,
    "close_category": "",
    "close_date": "2027-02-18",
    "close_reason": "",
    "closed_at": null,
    "competitor": "Distribütör ürünü",
    "cur_sym": "€",
    "currency": "EUR",
    "custom_fields": [
      {
        "key": "rakip_fiyat",
        "label": "Rakip fiyatı",
        "type": "currency",
        "value": null
      }
    ],
    "customer": "Alize Paketleme San. ve Tic. A.Ş.",
    "customer_city": "İstanbul",
    "customer_id": 1,
    "days_in_stage": 11,
    "demos": [],
    "detail_status": "",
    "fc": "Pipeline",
    "gate_ok": false,
    "gate_problems": [
      "BANT kriterleri 4/4 sağlanmalı (Budget · Authority · Need · Time)"
    ],
    "gate_warnings": [],
    "guide": "BANT 4/4",
    "health": {
      "grade": "success",
      "label": "sağlıklı",
      "score": 92
    },
    "health_color": "g",
    "health_manual": false,
    "health_note": "",
    "health_why": [
      [
        "−8"
      ]
    ],
    "id": 31,
    "initials": "AP",
    "is_account": false,
    "is_open": true,
    "last_update": "2026-10-12",
    "lifetime_left": 169,
    "line": "",
    "logs": [
      {
        "date": "2026-10-04T08:00:00",
        "from": null,
        "note": "Proje açıldı",
        "to": "Qualify",
        "user": "Deniz Aksoy"
      }
    ],
    "name": "Mevcut Müşteri — Yenileme · 2026",
    "next_stage": "Viable",
    "next_step": "İhtiyaç, hat ve aylık miktar potansiyelini netleştir (Need)",
    "note": "Hat hızı 300 m/dk'ya çıkacak; viskozite penceresi önemli.",
    "notes": [],
    "offer_price": null,
    "offers": [],
    "orders": [],
    "owner": {
      "color": "#5867e8",
      "full_name": "Deniz Aksoy",
      "id": 1,
      "photo": null,
      "role": "admin",
      "role_label": "Yönetici",
      "username": "admin"
    },
    "payment_days": null,
    "potential_kg": 6000.0,
    "prob": 0.1,
    "probability": null,
    "product": "PU-SL 200 Solventsiz Laminasyon Yapıştırıcısı",
    "product_id": 1,
    "pu": "€/kg",
    "rid": "006aTpWeStFXTOI",
    "sla_days": 30,
    "sla_left": 19,
    "source": "Bayi / distribütör",
    "stage": "Qualify",
    "stage_label": "Qualify",
    "start_date": "2026-10-04",
    "steps": [
      {
        "assignee": {
          "color": "#5867e8",
          "full_name": "Deniz Aksoy",
          "id": 1,
          "photo": null,
          "role": "admin",
          "role_label": "Yönetici",
          "username": "admin"
        },
        "auto": true,
        "done": true,
        "due_date": null,
        "id": 376,
        "note": "otomatik: BANT kutusu",
        "stage": "Qualify",
        "state": "done",
        "title": "Karar verici / yetkili kişiyi belirle (Authority)"
      }
    ],
    "tags": [],
    "tasks": [],
    "threads": [
      {
        "category": "musteri",
        "category_color": "#2a78d6",
        "category_label": "Müşteri yazışması",
        "category_source": "rule",
        "customer": "Alize Paketleme San. ve Tic. A.Ş.",
        "customer_id": 1,
        "id": 1,
        "last_at": "2026-10-15T06:02:00",
        "last_dir": "in",
        "n": 2,
        "opp": "Mevcut Müşteri — Yenileme · 2026",
        "opp_how": "single",
        "opp_id": 31,
        "opp_note": "firmanın tek açık projesi",
        "peer": "Selin Doğan",
        "subject": "Tanışma görüşmesi ve teknik föyler",
        "suggested": false,
        "waiting": true
      }
    ],
    "threads_n": 2,
    "trend": "",
    "trend_label": "Otomatik",
    "type": "Mevcut Müşteri — Yenileme",
    "unit": "kg",
    "unit_code": "kg",
    "value": 302000.0,
    "value_base": 302000.0,
    "value_short": "302K",
    "visits": [
      {
        "action_date": "2026-10-30",
        "action_done": false,
        "action_state": "open",
        "contact": "Selin Doğan",
        "customer": "Alize Paketleme San. ve Tic. A.Ş.",
        "customer_id": 1,
        "date": "2026-10-04",
        "id": 73,
        "line": "",
        "next_action": "Ziyaret Planla",
        "note": "Aylık tüketim ve stok seviyesi konuşuldu; sipariş tahmini alındı.",
        "opp": "Mevcut Müşteri — Yenileme · 2026",
        "opp_id": 31,
        "product": "",
        "result": "Bütçe onayı bekleniyor",
        "rid": "00UuPRn6Jj1l9UU",
        "topic": "Tanışma",
        "type": "Call",
        "user": "Deniz Aksoy"
      }
    ],
    "weighted": 30200.0
  }
}

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