beel_get_invitation
Read-onlyIdempotent
Retrieve a specific account invitation by account and invitation ID, including its status (accepted, revoked, or expired) to audit who was granted access to fiscal data.
Instructions
Returns one invitation of the account, with the same shape the list returns. An invitation stays readable for its whole life: ACCEPTED, REVOKED and EXPIRED ones are returned with their status, because the record is the trail of who was granted access to the account's fiscal data and revoking it does not erase it.
BeeL API endpoint: GET /v1/accounts/{account_id}/invitations/{invitation_id} (reference: https://docs.beel.es)
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": {
"account_id": "<account_id>",
"invitation_id": "<invitation_id>"
},
"name": "beel_get_invitation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account_id | Yes | Your own account, or an account you provisioned. It — not the credential — decides which account the operation acts on; a `403` is returned when you do not reach it, the same response an account that does not exist gets. | |
| invitation_id | Yes | Identifier (UUID) of an invitation of the account in the path, as returned when it is created or listed. An invitation of another account answers `404`, exactly like one that does not exist. |