View source for API getservicesalltotalroots

''7Kas VoIP REST API function. Available to: '''SuperRoot'''.''

== Description ==
One services-total row per root/operator (incl. root 0) for the month, at the wholesale tier — for per-operator pay-per-use billing (Dolibarr). SuperRoot only. Optional service=<prefix> (single service reads VOC by prefix; all-services reads TOC).

== Call ==
 GET  …/7Kas?func=getservicesalltotalroots&ukey=YOUR_KEY&…
Requires the <code>ukey</code> parameter.

== Parameters ==
{| class="wikitable sortable"
! Parameter !! Type !! Required !! Default !! Meaning
|-
| <code>year</code> || integer || Yes || — || Year.
|-
| <code>month</code> || integer || Yes || — || Month, 1-12.
|-
| <code>service</code> || string || No || — || Service prefix. Omit for all services. <small>(max 20)</small>
|}
== Example ==
 <nowiki>https://api.7kas.com:9080/7Kas?func=getservicesalltotalroots&ukey=SRKEY&year=2026&month=7</nowiki>

== Response ==
FillRecords2JSON: root_id, total_rows, total_billsec, total_accountcode_total, total_provider_total.

== Column visibility by profile ==
Pricing/cost columns depend on the caller's profile (GOD LAW):
* '''SuperRoot''' — provider cost + selling price + profit (VOC only).
* '''Operator''' — account price + root price + profit (VOC only).
* '''Client (direct, root=0)''' — only its own selling price (accountcode column).
* '''Client (of operator, root>0)''' — only its own selling price (root column).

----
Back to [[API VoIP]] · '''[[API Console|▶ Try it live]]''' · Profiles: [[API profile SuperRoot]]
[[Category:API SuperRoot]][[Category:API function]]