VAT Return Summary

GET https://app.speybooks.com/api/v1/reports/vat

VAT return data for a period. Computes output VAT (on revenue) and input VAT (on expenses) from transaction lines with non-zero VAT rates.

The response includes:

  • breakdown — per-rate net and VAT amounts, split by output (revenue) and input (expenses). This is the data needed to render a detailed VAT rate table.
  • vatLiabilityMovement — movement on the VAT liability control account (2100) for the period.
  • boxes — standard HMRC boxes 1–9 mapping.

The payable flag is true when net VAT is positive (owe HMRC). The reclaimable flag is true when net VAT is negative (refund due).

All amounts are in minor units (pence).

Query parameters

from string required
date
to string required
date

Response

200 Default Response
Show response fields
boxes object
Show child attributes
box1 integer
box2 integer
box3 integer
box4 integer
box5 integer
box6 integer
box7 integer
box8 integer
box9 integer
breakdown array<object>
Show child attributes
netAmount integer
rate integer
type string
vatAmount integer
inputVat integer
netVat integer
outputVat integer
payable boolean
period object
Show child attributes
from string
to string
reclaimable boolean
vatLiabilityMovement integer