List VAT returns

Returns the company's VAT returns (ADDED_TAX) and VIES statements (VIES), the latest period first, each with its period, status, filed, period_filed, period_running, due_date, overdue, completed_at and, for a completed VAT return, filed_net_vat (the net VAT it declared: positive payable, negative refundable). Read on every request: filed is true once a person completed this return in Cybooks (status completed); period_filed is true once the period is closed to corrections (the tax lock date reaches it, or a completed VAT or OSS return covers it), while the return itself may still be a draft that must be filed. overdue is true when the return is not filed and its due date has passed (on the due date it is on time). Filter by tax_type, status and year (the year the period ends in); paged with page (at most 100000) and per_page (default 50, at most 200; truncated is true while more returns follow). Read only: Cybooks never files a return. Requires the reports:read OAuth scope with view_vat_returns.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
enum

ADDED_TAX for VAT returns or VIES for VIES statements. Default: both

Allowed:
string
enum

draft or completed. Default: both

Allowed:
integer
2000 to 2100

The year the period ends in

integer
1 to 100000

Page of returns, latest period first. Default: 1, max: 100000

integer
1 to 200

Returns per page. Default: 50, max: 200

Responses

Language
Credentials
OAuth2
Missing 1 required scope
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
*/*