Get appointments

Get appointments for the current patient, or for a specific patient if admin/supervisor/coordinator and patient_id is provided. Supervisor/coordinator: only patients in their supervised scope.

limitinteger

Number of appointments to return (default: 20, most recent)

cursorstring nullable

Cursor for the next page.

appointment_typestring nullable

Filter by appointment type (CALL_CONOSCITIVA, CALL_GRATUITA, INCONTRO_PSICOLOGO, INCONTRO_NUTRIZIONISTA)

date_fromstring nullable

Filter by date range - start date (YYYY-MM-DD format, inclusive)

date_tostring nullable

Filter by date range - end date (YYYY-MM-DD format, inclusive)

patient_idstring uuid nullable

Patient ID. If provided, returns that patient's appointments. If omitted, returns current user's appointments.

collapse_joint_appointmentsboolean

Return a joint appointment as a single item instead of one row per expert. Set to false to get each expert's own appointment, as per-profession sections need. Ignored when patient_id is set.

Response

Successful Response

totalinteger required

Total number of appointments

next_cursorstring nullable

Cursor for the next page.

has_moreboolean

Whether there are more results after this page

has_valid_appointmentsboolean required

True if patient has at least one valid appointment (not cancelled or refunded)

has_valid_call_conoscitivaboolean required

True if patient has a valid call conoscitiva (DA_FARE or FATTO, not cancelled/refunded)

has_valid_call_gratuitaboolean required

True if patient has a valid call informativa (DA_FARE, FATTO, or DA_RIPROGRAMMARE; not cancelled)

has_completed_call_conoscitivaboolean required

True if patient has completed a call conoscitiva (FATTO, not cancelled/refunded)

has_pending_call_conoscitivaboolean required

True if patient has a pending call conoscitiva (DA_FARE, not cancelled/refunded)

can_book_repeat_call_conoscitivaboolean

True if patient can book another call conoscitiva because both paths have been abandoned or concluded for the configured threshold

has_completed_call_gratuita_questionnaireboolean

True if patient has completed at least one call informativa questionnaire

has_valid_appointments_by_professionobject required

Dict with PSICOLOGO and NUTRIZIONISTA keys, True if has valid appointments for that profession

is_first_appointment_by_professionobject required

Dict with PSICOLOGO and NUTRIZIONISTA keys, True if this is the first appointment (no completed appointments)

has_pending_appointments_by_professionobject required

Dict with PSICOLOGO and NUTRIZIONISTA keys, True if has pending appointments (DA_FORE with payment not succeeded)

has_assigned_psychologistboolean required

True if patient has an assigned psychologist

has_assigned_nutritionistboolean required

True if patient has an assigned nutritionist

Example response

{
  "appointments": [
    {
      "appointment_datetime": "2025-11-20T10:00:00+00:00",
      "appointment_type_code": "CALL_CONOSCITIVA",
      "created_at": "2025-11-15T10:00:00+00:00",
      "duration_seconds": 3600,
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "location": "online",
      "meeting_link_status": "not_created",
      "operator_first_name": "Mario",
      "operator_id": "123e4567-e89b-12d3-a456-426614174001",
      "operator_last_name": "Rossi",
      "operator_profession": "PSICOLOGO",
      "paid_with_coupon": false,
      "patient_cost": 49,
      "payment_completed_at": "2025-11-15T10:30:00+00:00",
      "payment_status": "succeeded",
      "status": "DA_FARE"
    }
  ],
  "can_book_repeat_call_conoscitiva": false,
  "has_assigned_nutritionist": false,
  "has_assigned_psychologist": true,
  "has_completed_call_conoscitiva": false,
  "has_completed_call_gratuita_questionnaire": true,
  "has_more": false,
  "has_pending_appointments_by_profession": {
    "NUTRIZIONISTA": false,
    "PSICOLOGO": true
  },
  "has_pending_call_conoscitiva": true,
  "has_valid_appointments": true,
  "has_valid_appointments_by_profession": {
    "NUTRIZIONISTA": false,
    "PSICOLOGO": true
  },
  "has_valid_call_conoscitiva": true,
  "has_valid_call_gratuita": false,
  "is_first_appointment_by_profession": {
    "NUTRIZIONISTA": true,
    "PSICOLOGO": false
  },
  "total": 1
}

Get appointments

Query parameters

Response

Example response

Changes