List fair leads

Leads collected at a fair (max 300, newest first).

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

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

ownerstringoptional

me (default for sales users), empty = everyone, or a user id.

intereststringoptional

Interest level.

ValuesSıcakIlıkSoğuk

qstringoptional

Company, person or phone contains.

Errors

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

Request

curl "https://ornek.solk.app/api/v1/fairs/1/leads?owner=" \
  -H "Authorization: Bearer $SOLK_API_KEY"

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

Response

{
  "fair": {
    "id": 1,
    "name": "Ambalaj Fuarı 2026 (örnek)"
  },
  "ok": true,
  "rows": [
    {
      "can_edit": true,
      "city": "Bursa",
      "company": "Işıltı Ambalaj San. Tic. Ltd. Şti.",
      "contact_name": "Mehmet Arslan",
      "created_at": "2026-08-28T14:10:00",
      "customer_id": null,
      "email": "mehmet@isiltiambalajsanti.example",
      "fair": "Ambalaj Fuarı 2026 (örnek)",
      "fair_id": 1,
      "id": 4,
      "initials": "IA",
      "interest": "Soğuk",
      "line": "",
      "next_action": "Numune gönder",
      "next_date": "2026-10-07",
      "note": "Stantta görüşüldü.",
      "opp_id": null,
      "opp_type": "Mevcut Müşteri — Değişim",
      "owner": {
        "full_name": "Deniz Aksoy",
        "id": 1,
        "role": "admin",
        "role_label": "Yönetici",
        "username": "admin"
      },
      "phone": "0 (224) 000 96 45",
      "potential_kg": 6000.0,
      "products": "4",
      "products_text": "",
      "project_note": "",
      "rid": "00QCwrpUC4bpt3E",
      "sector": "Gıda ambalajı",
      "status": "Teklif verildi",
      "status_eff": "Teklif verildi",
      "supplier": "Mevcut tedarikçi (Asya)",
      "task_id": null,
      "timing": "6 ay içinde",
      "title": "Kalite Kontrol Müdürü",
      "unit": "kg",
      "visitor_type": "Potansiyel müşteri",
      "wa": "902240009645",
      "website": ""
    },
    {
      "can_edit": true,
      "city": "Tekirdağ",
      "company": "Nehirli Ambalaj San. Tic. Ltd. Şti.",
      "contact_name": "İpek Karaca",
      "created_at": "2026-08-28T12:10:00",
      "customer_id": null,
      "email": "ipek@nehirliambalajsant.example",
      "fair": "Ambalaj Fuarı 2026 (örnek)",
      "fair_id": 1,
      "id": 8,
      "initials": "NA",
      "interest": "Soğuk",
      "line": "",
      "next_action": "Teklif gönder",
      "next_date": "2026-10-13",
      "note": "Stantta görüşüldü.",
      "opp_id": null,
      "opp_type": "Mevcut Müşteri — Değişim",
      "owner": {
        "full_name": "Deniz Aksoy",
        "id": 1,
        "role": "admin",
        "role_label": "Yönetici",
        "username": "admin"
      },
      "phone": "0 (282) 000 76 98",
      "potential_kg": 2000.0,
      "products": "3",
      "products_text": "",
      "project_note": "",
      "rid": "00QBIhQqejYyYc3",
      "sector": "Film üretimi",
      "status": "Teklif verildi",
      "status_eff": "Teklif verildi",
      "supplier": "Mevcut tedarikçi (Asya)",
      "task_id": null,
      "timing": "Hemen",
      "title": "Satın Alma Müdürü",
      "unit": "kg",
      "visitor_type": "Potansiyel müşteri",
      "wa": "902820007698",
      "website": ""
    }
  ],
  "total": 10
}

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