Companies

Activity form options

What an activity (quick entry) form needs: the company's open projects, the default project, people, open actions and last stage label.

GET/api/v1/customers/{id}/lookup

Authorization

Authorizationheaderrequired

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

Module: CustomersScope: crm.read

Path parameters

idintegerrequired

Company id.

Errors

HTTP	error	Meaning
`404`	`not_found`	Record not found.

Request

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

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

Response

{
  "city": "İstanbul",
  "competitor": "Distribütör ürünü",
  "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"
    }
  ],
  "default_project": 31,
  "id": 1,
  "name": "Alize Paketleme San. ve Tic. A.Ş.",
  "ok": true,
  "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"
    }
  ],
  "opp_type": "Mevcut Müşteri — Yenileme",
  "potential_kg": 8000.0,
  "projects": [
    {
      "id": 31,
      "name": "Mevcut Müşteri — Yenileme · 2026",
      "stage": "Qualify"
    },
    {
      "id": 44,
      "name": "Müşteri Takibi",
      "stage": "Müşteri Takibi"
    }
  ],
  "stage": "Qualify",
  "stage_label": "",
  "status": "AC"
}

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