https://wiki.7kas.com/index.php?action=history&feed=atom&title=API_getincomingcalls API getincomingcalls - Revision history 2026-09-06T23:58:34Z Revision history for this page on the wiki MediaWiki 1.43.9 https://wiki.7kas.com/index.php?title=API_getincomingcalls&diff=371&oldid=prev Maintenance script: API docs (generated from func=help) 2026-07-21T22:33:35Z <p>API docs (generated from func=help)</p> <p><b>New page</b></p><div>&#039;&#039;7Kas VoIP REST API function. Available to: &#039;&#039;&#039;SuperRoot, Operator, Client&#039;&#039;&#039;.&#039;&#039;<br /> <br /> == Description ==<br /> Incoming-call records for a period. model=vic (detail, supports day/hour) or tic (totals). Role-based columns: clients see only their own account (accountcodeid forced) and their selling price; operators their scope; SuperRoot everything incl. provider costs. SHM fast-path + PostgreSQL fallback. Server-side search on src/dst.<br /> <br /> == Call ==<br /> GET …/7Kas?func=getincomingcalls&amp;ukey=YOUR_KEY&amp;…<br /> Requires the &lt;code&gt;ukey&lt;/code&gt; parameter.<br /> <br /> == Parameters ==<br /> {| class=&quot;wikitable sortable&quot;<br /> ! Parameter !! Type !! Required !! Default !! Meaning<br /> |-<br /> | &lt;code&gt;year&lt;/code&gt; || integer || Yes || — || Year (e.g. 2026).<br /> |-<br /> | &lt;code&gt;month&lt;/code&gt; || integer || Yes || — || Month, 1-12.<br /> |-<br /> | &lt;code&gt;model&lt;/code&gt; || string || No || &lt;code&gt;vic&lt;/code&gt; || vic = detail records; tic = totals. &lt;small&gt;(valid: vic|tic (case-insensitive))&lt;/small&gt;<br /> |-<br /> | &lt;code&gt;accountcodeid&lt;/code&gt; || integer || No || — || Filter by account id (non-clients). Forced to own for clients.<br /> |-<br /> | &lt;code&gt;day&lt;/code&gt; || integer || No || — || Filter by day (1-31). &lt;small&gt;(model=vic only)&lt;/small&gt;<br /> |-<br /> | &lt;code&gt;hour&lt;/code&gt; || integer || No || — || Filter by hour (0-23). &lt;small&gt;(model=vic only, requires day)&lt;/small&gt;<br /> |-<br /> | &lt;code&gt;limit&lt;/code&gt; || integer || No || &lt;code&gt;100&lt;/code&gt; || Max rows. SHM up to 10000, PostgreSQL up to 1000.<br /> |-<br /> | &lt;code&gt;offset&lt;/code&gt; || integer || No || &lt;code&gt;0&lt;/code&gt; || Pagination offset.<br /> |-<br /> | &lt;code&gt;search&lt;/code&gt; || string || No || — || Server-side search pattern. &lt;small&gt;(max 40)&lt;/small&gt;<br /> |-<br /> | &lt;code&gt;search_fields&lt;/code&gt; || string || No || — || Comma-separated fields to search (whitelist: src, dst). &lt;small&gt;(max 200)&lt;/small&gt;<br /> |-<br /> | &lt;code&gt;search_mode&lt;/code&gt; || string || No || &lt;code&gt;contains&lt;/code&gt; || Match mode. &lt;small&gt;(prefix|suffix|contains|exact)&lt;/small&gt;<br /> |}<br /> == Example ==<br /> &lt;nowiki&gt;https://api.7kas.com:9080/7Kas?func=getincomingcalls&amp;ukey=KEY&amp;year=2026&amp;month=7&amp;model=vic&amp;limit=100&lt;/nowiki&gt;<br /> <br /> == Response ==<br /> FillRecords2JSON records (columns depend on role).<br /> <br /> == Column visibility by profile ==<br /> Pricing/cost columns depend on the caller&#039;s profile (GOD LAW):<br /> * &#039;&#039;&#039;SuperRoot&#039;&#039;&#039; — provider cost + selling price + profit (VOC only).<br /> * &#039;&#039;&#039;Operator&#039;&#039;&#039; — account price + root price + profit (VOC only).<br /> * &#039;&#039;&#039;Client (direct, root=0)&#039;&#039;&#039; — only its own selling price (accountcode column).<br /> * &#039;&#039;&#039;Client (of operator, root&gt;0)&#039;&#039;&#039; — only its own selling price (root column).<br /> <br /> ----<br /> Back to [[API VoIP]] · &#039;&#039;&#039;[[API Console|▶ Try it live]]&#039;&#039;&#039; · Profiles: [[API profile SuperRoot]], [[API profile Operator]], [[API profile Client (of operator)]], [[API profile Client (direct)]]<br /> [[Category:API SuperRoot]][[Category:API Operator]][[Category:API Client]][[Category:API function]]</div> Maintenance script