List withholdings (ritenute owed), newest first
Ritenute d’acconto the company withholds as sostituto d’imposta on fees paid to professionals and agents, one per received fee. Fees on professionals’ invoices received from SDI (DatiRitenuta RT01/RT02) are recorded on arrival; set paid_on when you pay the fee: the ritenuta is then due with F24 code 1040 by the 16th of the next month (art. 25 DPR 600/1973, art. 18 D.Lgs. 241/1997).
Ritenute d’acconto the company withholds as sostituto d’imposta on fees paid to professionals and agents, one per received fee. Fees on professionals’ invoices received from SDI (DatiRitenuta RT01/RT02) are recorded on arrival; set paid_on when you pay the fee: the ritenuta is then due with F24 code 1040 by the 16th of the next month (art. 25 DPR 600/1973, art. 18 D.Lgs. 241/1997).
apiKeyAuthorizationBearer <token>API key: gb_test_… or gb_live_…
limit?integerPage size, 1–100
1 <= value <= 10020cursor?stringnext_cursor of the previous page
1 <= length <= 200paid_in?stringFees paid in this month (2026-10) or year (2026): what the F24 of the month or the CU of the year contains
^\d{4}(-(0[1-9]|1[0-2]))?$status?stringunpaid: the fee is not paid yet (nothing withheld yet); withheld: paid, ritenuta to pay with F24 1040 by due_date; remitted: paid with an F24 recorded in getbeel
"unpaid""withheld""remitted"Getbeel-Company?stringAct on one of the account's client companies (its id from GET /companies) instead of the key's own account. 404 company_not_found when the key cannot act on it.
uuidOK
application/json- response
object*stringdata*array<>has_more*booleannext_cursor*string|nullcurl -X GET 'https://www.getbeel.com/api/v1/withholdings'{ "object": "list", "data": [ { "id": "wht_3f2a…", "object": "withholding", "source": "sdi", "invoice_id": "string", "recipient": { "name": "string", "fiscal_code": "string", "vat": "string" }, "document": { "number": "string", "date": "2026-10-29" }, "type": "RT01", "causale": "string", "rate": "122.00", "gross_amount": "122.00", "not_subject_amount": "122.00", "taxable_amount": "122.00", "withheld_amount": "122.00", "tax_code": "1040", "paid_on": "2026-10-29", "period": "string", "status": "unpaid", "due_date": "2026-10-29", "overdue": true, "filing_id": "string", "needs_review": true, "notes": "string", "created_at": "2019-08-24T14:15:22Z", "updated_at": "2019-08-24T14:15:22Z" } ], "has_more": true, "next_cursor": "string"}Comment on a filing POST
Adds a comment to the history, read by the team and the commercialista. Live keys only.
Record a fee subject to withholding POST
A fee not received through SDI (paper invoice, notula of occasional work). withheld_amount is computed when left out. Live keys only (403 livemode_required). Free.