Skip to main content
GET
Read the next assigned VAT return and its exact draft

Authorizations

Authorization
string
header
required

Portal API key minted in portal Settings → API access. Scope read or write; pinned to one company. Send as Authorization: Bearer lac_sk_....

Query Parameters

customer_id
string

Target company. Optional — API keys are pinned to one company, and single-company sessions default to it.

preview
boolean
default:false
period
string

Refuse a changed next period.

field
string

VAT field to page.

Pattern: ^(30[1-7]|309|31[0-9]|320)$
offset
integer
Required range: 0 <= x <= 1000000
books_fingerprint
string

Refuse changed books when paging.

payload_hash
string

Refuse a changed saved draft when paging.

Response

Next return or null; preview contains at most twenty transactions per field.

customer_id
string
required
actor
object
required
actions
object[]
required
upcoming
null | object
required
preview
object