GetbeelDocs

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.

GET
/companies/me/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.

Autorizzazione

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Corpo della risposta

OK

application/json
  1. response

null means not set yet (see missing_settings of the tax calendar)

object*string
vat_periodicity*|null
withholding_agent*|null
oss_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*boolean

Automatic 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*integer

Days before the due date for the automatic preparation (1-30, default 5).

Range1 <= value <= 30
require_accountant_approval*boolean

Read-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.

Esempio di richiesta
curl -X GET 'https://www.getbeel.com/api/v1/companies/me/tax-settings'
Esempio di risposta
{  "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}