curl --request GET \
  --url https://api.zivio.net/api/v4/invoices/summary \
  --header 'Authorization: Bearer <token>' \
  --header 'zivio-tenant-id: <api-key>'

import requests

url = "https://api.zivio.net/api/v4/invoices/summary"

headers = {
    "Authorization": "Bearer <token>",
    "zivio-tenant-id": "<api-key>"
}

response = requests.get(url, headers=headers)

print(response.text)

const options = {
  method: 'GET',
  headers: {Authorization: 'Bearer <token>', 'zivio-tenant-id': '<api-key>'}
};

fetch('https://api.zivio.net/api/v4/invoices/summary', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.zivio.net/api/v4/invoices/summary",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Bearer <token>",
    "zivio-tenant-id: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.zivio.net/api/v4/invoices/summary"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Authorization", "Bearer <token>")
	req.Header.Add("zivio-tenant-id", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

HttpResponse<String> response = Unirest.get("https://api.zivio.net/api/v4/invoices/summary")
  .header("Authorization", "Bearer <token>")
  .header("zivio-tenant-id", "<api-key>")
  .asString();

require 'uri'
require 'net/http'

url = URI("https://api.zivio.net/api/v4/invoices/summary")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
request["zivio-tenant-id"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "summary": {
    "resource": "invoices",
    "group_by": [
      "category",
      "supplier"
    ],
    "measures": [
      "net_total"
    ],
    "filters": {
      "dated_on": {
        "gte": "2025-01-01",
        "lte": "2025-12-31"
      },
      "status": "paid"
    },
    "defaults_applied": [
      "status"
    ],
    "currency": {
      "mode": "converted",
      "convert_to": "GBP",
      "rates_as_of": "2026-06-11"
    },
    "meta": {
      "group_count": 1,
      "returned": 1,
      "truncated": false,
      "order": "net_total desc"
    },
    "groups": [
      {
        "dimensions": [
          {
            "key": "category",
            "id": 42,
            "label": "Construction"
          },
          {
            "key": "supplier",
            "id": 88,
            "label": "Acme Build Ltd"
          }
        ],
        "net_total": {
          "amount": "1250000.00",
          "currency": "GBP",
          "cents": 125000000
        },
        "share": 100,
        "invoice_count": 87,
        "by_currency": [
          {
            "currency": "GBP",
            "net_total_cents": 125000000,
            "invoice_count": 87
          }
        ]
      }
    ],
    "totals": {
      "net_total": {
        "amount": "1250000.00",
        "currency": "GBP",
        "cents": 125000000
      },
      "invoice_count": 87
    }
  }
}

{
  "error": "invalid_token",
  "error_description": "The access token provided is expired, revoked, malformed, or invalid for other reasons"
}

{
  "error": "insufficient_scope",
  "error_description": "The request requires higher privileges than provided by the access token",
  "required_scope": "invoices:read",
  "provided_scopes": [
    "welcome:read"
  ]
}

{
  "error": "measure 'net_total' is not permitted"
}