---
title: "Patient registration and payment snapshot"
method: GET
path: "/api/patients/finance/patient-payment-snapshot"
tags: ["patients"]
---

# Patient registration and payment snapshot

`GET /api/patients/finance/patient-payment-snapshot`

Admin-only patient registration/payment snapshot for a given month (defaults to the previous month). The exclusive cutoff is the start of the following month in the selected timezone.

## Query parameters

- `month` string, nullable — Target month in YYYY-MM. Defaults to the previous month.
- `timezone` string — Timezone used to build the midnight cutoff. Default: Europe/Rome.
- `price_per_appointment` integer — Unit price used in the paying-patient totals.

## Response `200`

Successful Response

- PatientPaymentSnapshotResponse — Patient payment snapshot response model.
  - `cutoff_at` string, date-time, required — Exclusive cutoff timestamp used for the snapshot
  - `price_per_appointment` integer, required — Unit price used for totals
  - `total_registered_patients` integer, required — Patients created before the cutoff
  - `patients_without_payments` integer, required — Patients created before the cutoff with no completed payments before the cutoff
  - `paying_patients` PatientPaymentSnapshotBandRow[] — Breakdown of paying patients by completed paid appointments before the cutoff
    - `appointment_band` string, required — Appointment-count band for paying patients
    - `patient_count` integer, required — Number of patients in this band
    - `price` integer, required — Total price per patient in this band
    - `total` integer, required — Aggregate revenue for this band

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