Activities
Visits
The visit / activity list (by day, then entry time, newest first). Row: the visit fields + geo (location summary — only for the person who logged it and admins; null for others): st (ok at the company · far away · set the company location was saved from this visit · low uncertain · none no location), label, short, dist (m), in_time, out_time, duration (min), acc, in / out / firm ([lat, lng]), note, src (app · web · claude); plus time (arrival time, if allowed), user_id, customer_status, customer_city, can_edit, url. Response: rows, total, page, pages, has_next, stats (n, f2f, onsite, located, ok, located_pct, ok_pct, pending), scope, range, date_from, date_to, ranges, team (whether the team scope is available), geo_mode, radius.
Authorization
AuthorizationheaderrequiredBearer token: API key (sk_…), OAuth access token (mcp_…) or mobile session (xk_…).
Module: Visits / ActivitiesScope:
crm.readQuery parameters
scopestringoptionalmine (sales default), team the team I can see (admin default).Values
mineteamrangestringoptionaldefault: 30Period.
Values
todayweekmonth3090alldate_from / date_tostringoptionalDate range (YYYY-MM-DD) — overrides the period.
typestringoptionalActivity type.
Values
F2FOnlineCallDenemeownerintegeroptionalSalesperson (team scope).
customer_idintegeroptionalOnly this company (period defaults to
all).qstringoptionalSearch company, note, result or topic.
pendingbooleanoptionalOnly those with an open next action.
geostringoptionalnone on-site visits without a location, far away from the company (sales users: their own only).Values
nonefarpageintegeroptionaldefault: 1Page.
per_pageintegeroptionaldefault: 40Per page (10–100).
Request
curl https://ornek.solk.app/api/v1/visits \
-H "Authorization: Bearer $SOLK_API_KEY"const res = await fetch("https://ornek.solk.app/api/v1/visits", {
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/visits",
headers={"Authorization": f"Bearer {os.environ['SOLK_API_KEY']}"},
)
print(r.json())Response