VUZDevelopers

Get VAT report for specific month

GET
/vat-reports/monthly/{year}/{month}

Generate VAT report for a specific calendar month. Useful for historical monthly VAT reporting.

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

Path Parameters

year*number

Year (e.g., 2025)

month*number

Month (1-12)

Header Parameters

X-Business-Id*string

Response Body

application/json

curl -X GET "https://example.com/vat-reports/monthly/2025/1" \  -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"}