beel_get_company
Fetches a company's identity, fiscal data, Test/Live activation, VeriFactu registration, and stored editable contact, legal, bank, and payment fields by company ID.
Instructions
Returns the identity and activation state of a company: its fiscal data, whether it is switched on in Test and in Live, and its VeriFactu registration state.
It also returns every field PATCH /v1/companies/{company_id} accepts — contact
details, legal representative, bank details, IAE, activity start date, payment term and
the rendering block — so what was written can be read back without keeping a copy of it.
A field never set comes back absent: that means "nothing stored", not "hidden".
Its invoice series are not part of this response: read them from
GET /v1/companies/{company_id}/series.
BeeL API endpoint: GET /v1/companies/{company_id} (reference: https://docs.beel.es)
⚠️ Read before calling:
Which company an operation acts on, and how that is selected. (resource: beel://guardrails/multi-nif)
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"company_id": "<company_id>"
},
"name": "beel_get_company"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| company_id | Yes | Unique identifier (UUID) of the company the operation acts on — its identifier, not its NIF. It is the only source of context: the account that owns it is derived from it, and the `BeeL-Active-Company` header plays no part. A company you do not reach answers `403`, and so does a company that does not exist, so the existence of a company in another account is never disclosed. |