Trade fairs & leads

Lead entry: company card

The chosen registered company's card + contacts (contacts: id, name, title, phone, email, main, ini; main contact first) + open opportunities (opps: id, name, stage, hex, value).

GET/api/v1/fairs/{id}/lookup/co/{cid}

Authorization

Authorizationheaderrequired

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

Module: Fair leadsScope: crm.read

Path parameters

idintegerrequired

Fair id.

cidintegerrequired

Company id.

Query parameters

lidintegeroptional

The lead being edited.

Errors

HTTP	error	Meaning
`404`	`not_found`	Record not found.
`403`	`module`	The module is off in the licence or for the user.

Request

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

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

Response

{
  "company": {
    "city": "İstanbul",
    "contacts": [
      {
        "email": "selin.dogan@alizepaketleme.example",
        "h": 312,
        "id": 1,
        "ini": "SD",
        "main": true,
        "name": "Selin Doğan",
        "phone": "0 (212) 000 55 24",
        "title": "Satın Alma Müdürü"
      }
    ],
    "here": [],
    "id": 1,
    "initials": "AŞ",
    "n_contacts": 1,
    "n_open": 1,
    "name": "Alize Paketleme San. ve Tic. A.Ş.",
    "opps": [
      {
        "hex": "#8a9ba0",
        "id": 31,
        "name": "Mevcut Müşteri — Yenileme · 2026",
        "stage": "Qualify",
        "value": "403K €"
      }
    ],
    "owner": "Deniz Aksoy",
    "prev": [],
    "sector": "Gıda ambalajı",
    "status": "AC",
    "status_l": "Müşteri",
    "url": "/customers/1",
    "website": "www.alizepaketleme.example"
  },
  "ok": true
}

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