Sign in
availability

Get Available Slots

Get available slots for appointments. Requires authentication.

  • CALL_CONOSCITIVA / CALL_GRATUITA: Returns all operators with role customer_care
  • INCONTRO_PSICOLOGO: Returns only assigned psychologist slots
  • INCONTRO_NUTRIZIONISTA: Returns only assigned nutritionist slots

Location types:

  • online: Default, returns online slots (clinic_location_id is ignored)
  • in_person: Returns in-person slots (clinic_location_id is required)
get/api/availability

Query parameters

appointment_type'CALL_CONOSCITIVA' | 'CALL_GRATUITA' | 'CALL_SUPPORTO' | 'CALL_EXTRA' | 'INCONTRO_PSICOLOGO' | 'INCONTRO_NUTRIZIONISTA' | 'INCONTRO_CONGIUNTO' required

Appointment type constants.

limitinteger

Maximum number of slots to return

Maximum number of slots to return

location_typestring

Location type: 'online' or 'in_person'

Location type: 'online' or 'in_person'

clinic_location_idstring uuid nullable

Clinic location ID (required for in_person)

Clinic location ID (required for in_person)

include_bookedboolean

If true (only for CALL_CONOSCITIVA / CALL_GRATUITA), include already-booked slots with is_booked=true.

If true (only for CALL_CONOSCITIVA / CALL_GRATUITA), include already-booked slots with is_booked=true.

Response

Successful Response

idstring required

Availability slot UUID

slot_datetimestring date-time required

Slot date and time

duration_minutesinteger required

Duration in minutes

location_typestring required

Location type: 'online' or 'in_person'

clinic_location_idstring nullable

Clinic location UUID (null for online appointments)

room_idstring nullable

Room UUID (null for online appointments)

operator_idstring nullable

Operator UUID (null for CALL_CONOSCITIVA, assigned on booking)

operator_first_namestring nullable

Operator first name (null for CALL_CONOSCITIVA)

operator_last_namestring nullable

Operator last name (null for CALL_CONOSCITIVA)

operator_professionstring nullable

Operator profession (PSICOLOGO/NUTRIZIONISTA, null for CALL_CONOSCITIVA)

is_pending_reservationboolean

True if this slot has a pending reservation by the current user

pending_payment_idstring nullable

Payment ID if this slot has a pending reservation

is_bookedboolean

True if this slot is shown as already booked (real booking or scarcity placeholder). Only returned when include_booked=true.

Example response

[
  {
    "duration_minutes": 30,
    "id": "123e4567-e89b-12d3-a456-426614174000",
    "is_pending_reservation": false,
    "operator_first_name": "Mario",
    "operator_id": "123e4567-e89b-12d3-a456-426614174001",
    "operator_last_name": "Rossi",
    "operator_profession": "PSICOLOGO",
    "slot_datetime": "2025-11-20T10:00:00+00:00"
  }
]

Changes