GetbeelDocs

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.

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

Autorizzazione

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Corpo della risposta

OK

application/json
  1. response

Values are the effective profile: yours, else a high-confidence detection, else null

object*string
legal_form*|null
regime_fiscale*|

From the company profile (RF01 ordinario, RF19 forfettario…): changed there, confirmed here

vat_periodicity*|null
withholding_agent*boolean|null
has_employees*boolean|null
reverse_charge_suppliers*boolean|null
intrastat*boolean|null
oss_suggested*boolean

B2C 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|null
liquidation_from*|null
first_fiscal_year*|null
social_security*|null
social_security_fund*string|null
is_person*boolean

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

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