# List withholdings (ritenute owed), newest first (https://docs.getbeel.com/en/api/reference/taxes/listWithholdings)

## GET /withholdings

```json

{
  "operationId": "listWithholdings",
  "summary": "List withholdings (ritenute owed), newest first",
  "description": "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).",
  "tags": [
    "Taxes"
  ],
  "x-required-scope": "taxes:read",
  "parameters": [
    {
      "name": "limit",
      "in": "query",
      "required": false,
      "description": "Page size, 1–100",
      "schema": {
        "default": 20,
        "type": "integer",
        "minimum": 1,
        "maximum": 100
      }
    },
    {
      "name": "cursor",
      "in": "query",
      "required": false,
      "description": "`next_cursor` of the previous page",
      "schema": {
        "type": "string",
        "minLength": 1,
        "maxLength": 200
      }
    },
    {
      "name": "paid_in",
      "in": "query",
      "required": false,
      "description": "Fees paid in this month (2026-10) or year (2026): what the F24 of the month or the CU of the year contains",
      "schema": {
        "type": "string",
        "pattern": "^\\d{4}(-(0[1-9]|1[0-2]))?$"
      }
    },
    {
      "name": "status",
      "in": "query",
      "required": false,
      "description": "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",
      "schema": {
        "type": "string",
        "enum": [
          "unpaid",
          "withheld",
          "remitted"
        ]
      }
    },
    {
      "name": "Getbeel-Company",
      "in": "header",
      "required": false,
      "description": "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.",
      "schema": {
        "type": "string",
        "format": "uuid"
      }
    }
  ],
  "responses": {
    "200": {
      "description": "OK",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/WithholdingList"
          }
        }
      }
    },
    "400": {
      "description": "Invalid request",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "401": {
      "description": "Missing, invalid, revoked or expired API key",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "403": {
      "description": "The key lacks the 'taxes:read' scope",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "404": {
      "description": "company_not_found (Getbeel-Company)",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "429": {
      "description": "Rate limit exceeded; see Retry-After",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    },
    "500": {
      "description": "Server error; quote X-Request-Id",
      "content": {
        "application/json": {
          "schema": {
            "$ref": "#/components/schemas/Error"
          }
        }
      }
    }
  }
}

```

Full OpenAPI document: https://docs.getbeel.com/openapi.json