---
title: "Get Operators By User Ids"
method: POST
path: "/api/operators/by-user-ids"
tags: ["operators"]
---

# Get Operators By User Ids

`POST /api/operators/by-user-ids`

## Request body

- OperatorUserIdsRequest — Request model for fetching operators by user ids.
  - `user_ids` string[] — User UUIDs linked to operators
  - `include_supervisors` boolean — If true, include comma-separated supervisor_names in each row.

## Response `200`

Successful Response

- OperatorResponse[]
  - `user_id` string, uuid, nullable
  - `vat_code` string, nullable
  - `ssn_code` string, nullable
  - `pec` string, nullable
  - `tax_regime` string, nullable
  - `billing_name` string, nullable — Billing name (ragione sociale) used for invoicing; when set it replaces first/last name on Zucchetti
  - `profession` string, nullable
  - `iban` string, nullable
  - `work_place` string, nullable
  - `bio` string, nullable
  - `professional_registration_number` string, nullable
  - `professional_section` string, nullable
  - `regional_professional_order` string, nullable
  - `status` string, nullable
  - `accepts_new_patients` boolean, nullable
  - `default_appointment_cost` number, nullable
  - `operator_cost` number, nullable
  - `max_patients` integer, nullable
  - `call_duration` integer, nullable
  - `presentation_video` string, nullable
  - `spoki_key` string, nullable
  - `spoki_email` string, nullable
  - `slack_user_id` string, nullable
  - `id` string, uuid, required
  - `created_at` string, nullable
  - `updated_at` string, nullable
  - `has_in_person_availability` boolean
  - `user` OperatorUserResponse — Response model for operator user information.
    - `id` string, uuid, nullable — User UUID
    - `first_name` string, nullable — User first name
    - `last_name` string, nullable — User last name
    - `email` string, nullable — User email
    - `roles` string[] — Keycloak realm roles
    - `tax_code` string, nullable — User tax code
    - `phone` string, nullable — User phone
    - `home_address` string, nullable — User address
    - `city` string, nullable — User city
    - `province` string, nullable — User province
    - `postal_code` string, nullable — User postal code
    - `date_of_birth` string, nullable — Date of birth (YYYY-MM-DD)
    - `gender` string, nullable — User gender
    - `created_at` string, nullable — User creation timestamp ISO
  - `supervisor_names` string, nullable

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