---
title: "Get Operator Payments Summary By Tax Regime"
method: GET
path: "/api/operator-payments/summary/by-tax-regime"
tags: ["operator-payments"]
---

# Get Operator Payments Summary By Tax Regime

`GET /api/operator-payments/summary/by-tax-regime`

Get month summary aggregated by tax regime (completed appointments and bonifici totals)

## Query parameters

- `payment_month_from` string, date, nullable
- `payment_month_to` string, date, nullable

## Response `200`

Successful Response

- OperatorPaymentSummaryByTaxRegimeResponse
  - `items` OperatorPaymentSummaryByTaxRegimeRow[]
    - `tax_regime_code` string, nullable — Tax regime code (coalesced from invoice snapshot or operator profile); null when neither is set
    - `total_count` integer
    - `total_paid_count` integer
    - `total_appointments_fatti` integer
    - `total_paid_appointments_fatti` integer
    - `total_billable_visits` integer
    - `total_free_appointments` integer
    - `total_paid_free_appointments` integer
    - `total_applied_deducted_supervision_count` integer
    - `total_pending_deductible_supervision_count` integer
    - `total_paid_amount` string
    - `total_operators` integer

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corabea/corabea-api/revisions/13c1bce1bdc4/schema)