---
title: "Search Operators"
method: GET
path: "/api/operators/search"
tags: ["operators"]
---

# Search Operators

`GET /api/operators/search`

## Query parameters

- `q` string, required — Free text matched against operator name or email.
- `limit` integer — Maximum number of operators returned.
- `profession` 'PSICOLOGO' | 'NUTRIZIONISTA' — Operator profession constants.
- `include_supervisors` boolean — If true, each operator includes supervisor_names (comma-separated display names).

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