Get the tax profile
Which taxes apply to the company: legal form, regime, VAT periodicity, withholding agent, employees, foreign suppliers, Intrastat, OSS (sales evidence and the registration), liquidation, first tax year, social security and special income tax regimes, each with its `effect` for the current year (rate or taxed share, until when, F24 codes, the official source of each number) and `regime_warnings`. Each value is yours (sources: user) or a high-confidence detection (detected), with the evidence in `detection`; low-confidence values are never applied and come back in `questions` to ask the user once. Both key modes. Free.
Which taxes apply to the company: legal form, regime, VAT periodicity, withholding agent, employees, foreign suppliers, Intrastat, OSS (sales evidence and the registration), liquidation, first tax year, social security and special income tax regimes, each with its effect for the current year (rate or taxed share, until when, F24 codes, the official source of each number) and regime_warnings. Each value is yours (sources: user) or a high-confidence detection (detected), with the evidence in detection; low-confidence values are never applied and come back in questions to ask the user once. Both key modes. Free.
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
OK
application/json- response
Values are the effective profile: yours, else a high-confidence detection, else null
object*stringlegal_form*|nullregime_fiscale*|From the company profile (RF01 ordinario, RF19 forfettario…): changed there, confirmed here
vat_periodicity*|nullwithholding_agent*boolean|nullhas_employees*boolean|nullreverse_charge_suppliers*boolean|nullintrastat*boolean|nulloss_suggested*booleanB2C sales to other EU countries above the €10,000 EU threshold (evidence only: the OSS registration is a separate setting)
oss_registered*|Registered in the OSS union scheme: read-only, from the tax settings (oss_from set: true; "not registered" answered on the profile: false; null: not answered). Set it with PATCH /companies/me/tax-settings (oss_from, oss_until), which also adds the quarterly OSS returns
in_liquidation*boolean|nullliquidation_from*|nullfirst_fiscal_year*|nullsocial_security*|nullsocial_security_fund*string|nullis_person*booleanA natural person (ditta individuale, professionista)
regimes*array<>regime_warnings*array<>Mismatches between the RegimeFiscale of the company and the regimes in force: regime_code_mismatch (e.g. forfettario with RF01), regime_missing_for_code (RF19 without a forfettario regime), two_substitute_regimes, impatriati_with_forfettario (forfettario income cannot use the impatriati reduction), docenti_with_neo_residenti (not cumulable, L. 232/2016 c. 154), docenti_with_substitute_regime (forfettario or minimi income cannot use the docenti reduction)
sources*Per field: user (set by you: wins), detected (high-confidence detection, applied), unknown (asked in questions or left out), not_applicable
confirmed*Who confirmed each field, through what, when
detection*questions*array<>What to ask the user, once, in plain language. Never guess the answer: ask and PATCH it.
curl -X GET 'https://www.getbeel.com/api/v1/companies/me/tax-profile'{ "object": "tax_profile", "legal_form": "srl", "regime_fiscale": "string", "vat_periodicity": "monthly", "withholding_agent": true, "has_employees": true, "reverse_charge_suppliers": true, "intrastat": true, "oss_suggested": true, "oss_registered": true, "in_liquidation": true, "liquidation_from": "2026-10-29", "first_fiscal_year": -9007199254740991, "social_security": "gestione_separata", "social_security_fund": "string", "is_person": true, "regimes": [ { "kind": "irpef_ordinario", "valid_from": "2026-10-29", "valid_until": "2026-10-29", "params": { "property1": "string", "property2": "string" }, "id": "string", "source": "detected", "effect": { "kind": "irpef_ordinario", "year": -9007199254740991, "applies": true, "rate": { "value": 0, "source": { "title": "string", "url": "string", "article": "string" } }, "taxable_share": { "value": 0, "source": { "title": "string", "url": "string", "article": "string" } }, "income_cap": { "value": 0, "source": { "title": "string", "url": "string", "article": "string" } }, "ends_year": -9007199254740991, "tax_codes": { "first": "string", "second": "string", "balance": "string" }, "flat_tax": { "value": 0, "source": { "title": "string", "url": "string", "article": "string" } }, "notes": [ "string" ], "missing_rules": [ "string" ] } } ], "regime_warnings": [ { "key": "string", "params": { "property1": "string", "property2": "string" } } ], "sources": { "property1": "user", "property2": "user" }, "confirmed": { "property1": { "via": "user", "at": "string" }, "property2": { "via": "user", "at": "string" } }, "detection": { "detected_at": "string", "fields": { "property1": { "value": "string", "confidence": "high", "evidence": { "key": "string", "params": { "property1": "string", "property2": "string" } }, "held": { "value": "string", "confidence": "high", "evidence": { "key": "string", "params": { "property1": "string", "property2": "string" } }, "since": "string" } }, "property2": { "value": "string", "confidence": "high", "evidence": { "key": "string", "params": { "property1": "string", "property2": "string" } }, "held": { "value": "string", "confidence": "high", "evidence": { "key": "string", "params": { "property1": "string", "property2": "string" } }, "since": "string" } } } }, "questions": [ { "field": "legal_form", "question": "string" } ]}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.
Change the tax profile PATCH
Changes only what it sends and marks it confirmed; null clears a value (back to the detection); `confirm` confirms detected values as they are; `regimes` replaces the special income tax regimes; their `params` are typed per kind and getbeel computes the numbers from them. A value you set always wins over the detection and changes which deadlines the tax calendar lists. Ask the user, never guess. Recorded in the audit log. Live keys only.