GetbeelDocs

Detect the tax profile now

Re-runs the detection from the company data (name, regime, issued and received invoices, recorded withholdings), stores it and returns it with the profile. It never changes a value you set. New obligations (e.g. B2C sales above the OSS threshold) also add a notice in the app. getbeel runs it every month by itself. Live keys only.

POST
/companies/me/tax-profile/detect

Re-runs the detection from the company data (name, regime, issued and received invoices, recorded withholdings), stores it and returns it with the profile. It never changes a value you set. New obligations (e.g. B2C sales above the OSS threshold) also add a notice in the app. getbeel runs it every month by itself. Live keys only.

Authorization

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Response Body

OK

application/json
  1. response
object*string
detected_at*string
obligations*array<>

New obligations found by this run (a notice was added in the app)

changed*array<>

Fields whose detected value or confidence changed

held*array<>

Fields the new data would change in a way that removes or changes deadlines: kept as they were and marked held until you answer them

profile*

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

Example Request
curl -X POST 'https://www.getbeel.com/api/v1/companies/me/tax-profile/detect'
Example Response
{  "object": "tax_profile_detection",  "detected_at": "string",  "obligations": [    "legal_form"  ],  "changed": [    "legal_form"  ],  "held": [    "legal_form"  ],  "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"      }    ]  }}