GetbeelDocs

VAT for a month or quarter (estimate)

Sales VAT from the issued e-invoices accepted by SDI (credit notes subtract, split payment left out, deferred VAT apart) and an estimate of purchase VAT from reviewed supplier invoices in euros. reliable is always false: deductibility, the month of receipt and reverse charge are not known, so treat it as an estimate to check with the accountant ("da verificare"). It is never used for an F24.

GET
/companies/me/vat-position

Sales VAT from the issued e-invoices accepted by SDI (credit notes subtract, split payment left out, deferred VAT apart) and an estimate of purchase VAT from reviewed supplier invoices in euros. reliable is always false: deductibility, the month of receipt and reverse charge are not known, so treat it as an estimate to check with the accountant ("da verificare"). It is never used for an F24.

Authorization

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Query Parameters

period*string

A month (2026-10) or a quarter (2026-Q3)

Match^\d{4}-(Q[1-4]|0[1-9]|1[0-2])$

Response Body

OK

application/json
  1. response
object*string
period*string
start*string
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
Formatdate
end*string
Match^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))$
Formatdate
currency*string
no_vat_regime*boolean
vat_periodicity*|null
sales_vat*string

Decimal amount as a string

Match^-?\d+\.\d{2}$
sales_invoices*integer
Range-9007199254740991 <= value <= 9007199254740991
deferred_sales_vat*string

Decimal amount as a string

Match^-?\d+\.\d{2}$
split_payment_invoices*integer
Range-9007199254740991 <= value <= 9007199254740991
purchase_vat_estimate*string

Decimal amount as a string

Match^-?\d+\.\d{2}$
purchase_invoices*integer
Range-9007199254740991 <= value <= 9007199254740991
purchases_skipped_foreign_currency*integer
Range-9007199254740991 <= value <= 9007199254740991
balance_estimate*string

Positive: VAT to pay; negative: credit. An estimate.

Match^-?\d+\.\d{2}$
reliable*boolean
note*string
Example Request
curl -X GET 'https://www.getbeel.com/api/v1/companies/me/vat-position?period=2026-Q3'
Example Response
{  "object": "vat_position",  "period": "string",  "start": "2026-10-29",  "end": "2026-10-29",  "currency": "EUR",  "no_vat_regime": true,  "vat_periodicity": "monthly",  "sales_vat": "122.00",  "sales_invoices": -9007199254740991,  "deferred_sales_vat": "122.00",  "split_payment_invoices": -9007199254740991,  "purchase_vat_estimate": "122.00",  "purchase_invoices": -9007199254740991,  "purchases_skipped_foreign_currency": -9007199254740991,  "balance_estimate": "122.00",  "reliable": false,  "note": "string"}