Trade fairs & leads

Lead entry: company lookup

While entering a lead: registered company suggestions (q — Turkish-folded; exact name → prefix → word start → contains), leads at this fair with the same company / phone / e-mail (dups) and the CRM owner of a phone / e-mail (hit = {contact, company}). Company card: id, name, status_l, owner, city, sector, n_contacts, n_open (open opportunities), here (its leads at this fair), prev (earlier fairs), initials.

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

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.

Query parameters

qstringoptional

Company name (min 2 letters).

companystringoptional

Company name for the duplicate check (default q).

phonestringoptional

Phone (min 7 digits).

emailstringoptional

E-mail.

lidintegeroptional

The lead being edited (not counted as its own duplicate).

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?q=Alize%20&company=Alize%20Paketleme%20San.%20ve%20Tic.%20A.%C5%9E." \
  -H "Authorization: Bearer $SOLK_API_KEY"

const res = await fetch("https://ornek.solk.app/api/v1/fairs/1/lookup?q=Alize%20&company=Alize%20Paketleme%20San.%20ve%20Tic.%20A.%C5%9E.", {
  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",
    headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
    params={"q": "Alize ", "company": "Alize Paketleme San. ve Tic. A.Ş."},
)
print(r.json())

Response

{
  "companies": [
    {
      "city": "İstanbul",
      "here": [],
      "id": 1,
      "initials": "AŞ",
      "n_contacts": 1,
      "n_open": 1,
      "name": "Alize Paketleme San. ve Tic. A.Ş.",
      "owner": "Deniz Aksoy",
      "prev": [],
      "sector": "Gıda ambalajı",
      "status": "AC",
      "status_l": "Müşteri",
      "url": "/customers/1",
      "website": "www.alizepaketleme.example"
    }
  ],
  "dups": [],
  "hit": null,
  "ok": true
}

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