GetbeelDocs

CU and 770 data of a year

Per percipiente and causale, the fees paid in the year (cash principle) as the Certificazione Unica (lavoro autonomo, provvigioni e redditi diversi) reports them: punto 4 gross, 7 not subject, 8 taxable, 9 ritenute; the 770 quadro ST lines per month (codice 1040). Deadlines from the CU 2026 instructions: CU to each percipiente by 16 March; to the AdE by 16 March, or 30 April for lavoro autonomo abituale and non-occasional provvigioni; 770 by 31 October. format=csv returns a spreadsheet (text/csv). Not the telematic file.

GET
/withholdings/cu

Per percipiente and causale, the fees paid in the year (cash principle) as the Certificazione Unica (lavoro autonomo, provvigioni e redditi diversi) reports them: punto 4 gross, 7 not subject, 8 taxable, 9 ritenute; the 770 quadro ST lines per month (codice 1040). Deadlines from the CU 2026 instructions: CU to each percipiente by 16 March; to the AdE by 16 March, or 30 April for lavoro autonomo abituale and non-occasional provvigioni; 770 by 31 October. format=csv returns a spreadsheet (text/csv). Not the telematic file.

Authorization

apiKey
headerAuthorizationBearer <token>

API key: gb_test_… or gb_live_…

Query Parameters

year*integer

The year the fees were paid (cash principle)

Range2020 <= value <= 2100
format?string

csv: one row per percipiente and causale (semicolons, Italian decimals, for Excel)

Default"json"
Value in"json""csv"

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
year*integer
Range-9007199254740991 <= value <= 9007199254740991
recipients*array<>
totals*
deadlines*
missing_fiscal_codes*integer
Range-9007199254740991 <= value <= 9007199254740991
form_770*array<>

770 quadro ST, sezione I, per month

Example Request
curl -X GET 'https://www.getbeel.com/api/v1/withholdings/cu?year=2026'
Example Response
{  "object": "withholdings_cu",  "year": -9007199254740991,  "recipients": [    {      "key": "string",      "name": "string",      "fiscal_code": "string",      "vat": "string",      "lines": [        {          "causale": "string",          "gross_amount": "122.00",          "not_subject_amount": "122.00",          "taxable_amount": "122.00",          "withheld_amount": "122.00",          "remitted_amount": "122.00",          "payments": -9007199254740991        }      ],      "ade_due_date": "2026-10-29",      "missing_fiscal_code": true    }  ],  "totals": {    "recipients": -9007199254740991,    "gross_amount": "122.00",    "not_subject_amount": "122.00",    "taxable_amount": "122.00",    "withheld_amount": "122.00",    "remitted_amount": "122.00"  },  "deadlines": {    "to_recipients": "2026-10-29",    "to_ade": "2026-10-29",    "to_ade_professionals": "2026-10-29",    "form_770": "2026-10-29"  },  "missing_fiscal_codes": -9007199254740991,  "form_770": [    {      "period": "string",      "period_label": "string",      "withheld_amount": "122.00",      "paid_amount": "122.00",      "paid_on": "2026-10-29",      "tax_code": "1040",      "filing_id": "string"    }  ]}