VUZDevelopers

Generate VAT report for custom date range

GET
/vat-reports

Generate a comprehensive VAT report showing collected VAT, paid VAT, and net liability for a specified date range. Includes detailed transaction list and breakdown by document type.

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

startDate*string

Start date (ISO 8601 format, e.g., 2025-01-01)

endDate*string

End date (ISO 8601 format, e.g., 2025-01-31)

periodType?string

VAT period type (monthly or bi-monthly)

Value in

  • "monthly"
  • "bi-monthly"

Header Parameters

X-Business-Id*string

Response Body

application/json

curl -X GET "https://example.com/vat-reports?startDate=2025-01-01&endDate=2025-01-31" \  -H "X-Business-Id: string"
{  "businessId": "123e4567-e89b-12d3-a456-426614174000",  "startDate": "2025-01-01",  "endDate": "2025-01-31",  "totalVatCollected": 15300,  "totalVatPaid": 1800,  "netVatLiability": 13500,  "transactionCount": 45,  "documentTypeBreakdown": [    {      "documentType": "TAX_INVOICE",      "transactionCount": 15,      "totalVatCollected": 13500,      "totalVatPaid": 0,      "netVat": 13500    }  ],  "transactions": [    {      "transactionDate": "2025-01-15T10:00:00.000Z",      "referenceNumber": "60001",      "sourceDocumentId": "123e4567-e89b-12d3-a456-426614174000",      "details": "Invoice 60001 - VAT 18%",      "vatCollected": 900,      "vatPaid": 0,      "netVat": 900    }  ],  "generatedAt": "2025-01-18T12:00:00.000Z"}