VUZDevelopers

Get annual VAT summary

GET
/analytics/vat/annual

Retrieves comprehensive annual VAT summary with historical trend.

Data Returned:

  • Year totals (output, input, net VAT)
  • All periods with detailed data
  • 3-year trend comparison

Authorization

X-Api-Key<token>

Business API key, e.g. vuz_ab12cdef... Created via Settings → Integrations → API Keys. Unlike partner keys, a public API key's STRING does not encode its environment — isolation instead comes from a completely separate sandbox database: a key minted on the Sandbox server (above) only ever reads/writes sandbox data and can never see or affect production, regardless of what the key looks like.

In: header

Query Parameters

year?number

Year for annual summary

Response Body

application/json

application/json

curl -X GET "https://example.com/analytics/vat/annual"
{  "year": 0,  "totalOutputVAT": 0,  "totalInputVAT": 0,  "totalNetVAT": 0,  "periods": [    {      "period": "string",      "startDate": "string",      "endDate": "string",      "outputVAT": 0,      "inputVAT": 0,      "netVAT": 0,      "documentCount": 0,      "expenseCount": 0,      "currency": "string"    }  ],  "yearlyTrend": [    {      "year": 0,      "totalNetVAT": 0    }  ],  "currency": "string"}