GetbeelDocs

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

GET
/withholdings

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

Authorization

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Query Parameters

limit?integer

Page size, 1–100

Range1 <= value <= 100
Default20
cursor?string

next_cursor of the previous page

Length1 <= length <= 200
paid_in?string

Fees paid in this month (2026-10) or year (2026): what the F24 of the month or the CU of the year contains

Match^\d{4}(-(0[1-9]|1[0-2]))?$
status?string

unpaid: 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

Value in"unpaid""withheld""remitted"

Header Parameters

Getbeel-Company?string

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

Formatuuid

Response Body

OK

application/json
  1. response
object*string
data*array<>
has_more*boolean
next_cursor*string|null
Example Request
curl -X GET 'https://www.getbeel.com/api/v1/withholdings'
Example Response
{  "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"}