Get the tax settings
VAT periodicity and whether the company is a withholding agent, as Tasse → Impostazioni. null means not set: the deadlines that depend on it are left out of the tax calendar (missing_settings). Both key modes.
VAT periodicity and whether the company is a withholding agent, as Tasse → Impostazioni. null means not set: the deadlines that depend on it are left out of the tax calendar (missing_settings). Both key modes.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
OK
application/json- response
null means not set yet (see missing_settings of the tax calendar)
object*stringvat_periodicity*|nullwithholding_agent*|nulloss_from*|The day the OSS union scheme applies from (Portale OSS registration; Reg. 282/2011 art. 57d). null: not registered (also clears oss_until). Adds the quarterly OSS return and payment deadlines.
oss_until*|The day the OSS scheme stops applying (exit or exclusion). null: still registered.
auto_prepare*booleanAutomatic preparation (default true): getbeel prepares the F24 of bollo, ritenute and periodic VAT auto_prepare_days days before the due date, once the period is over and the amount is known, and sends filing.ready. false: only reminders.
auto_prepare_days*integerDays before the due date for the automatic preparation (1-30, default 5).
1 <= value <= 30require_accountant_approval*booleanRead-only here (an owner sets it in the app): when true, only the commercialista approves a filing, and a receipt or protocol number waits for that approval.
curl -X GET 'https://www.getbeel.com/api/v1/companies/me/tax-settings'{ "object": "tax_settings", "vat_periodicity": "monthly", "withholding_agent": true, "oss_from": "2026-10-29", "oss_until": "2026-10-29", "auto_prepare": true, "auto_prepare_days": 1, "require_accountant_approval": true}CU and 770 data of a year GET
Per percipiente and causale, the fees paid in the year (cash principle) as the Certificazione Unica (lavoro autonomo, provvigioni e redditi diversi) reports them: punto 4 gross, 7 not subject, 8 taxable, 9 ritenute; the 770 quadro ST lines per month (codice 1040). Deadlines from the CU 2026 instructions: CU to each percipiente by 16 March; to the AdE by 16 March, or 30 April for lavoro autonomo abituale and non-occasional provvigioni; 770 by 31 October. format=csv returns a spreadsheet (text/csv). Not the telematic file.
Change the tax settings PATCH
Changes only what it sends. The VAT periodicity decides the VAT periods (months or quarters) of the registers, liquidazioni and F24: change it only as the company actually settles VAT (ask the accountant). Live keys only.