---
title: "Get patients by list of IDs"
method: POST
path: "/api/patients/by-ids"
tags: ["patients"]
---

# Get patients by list of IDs

`POST /api/patients/by-ids`

Returns patients for the given list of patient UUIDs.

## Query parameters

- `fields` string, nullable — Filter fields: 'name_only' returns only id + name

## Request body

- string[]

## Response `200`

Successful Response

- union
  - PatientResponse[]
    - `id` string, uuid, required
    - `user_id` string, uuid, required
    - `psychologist_id` string, uuid, nullable
    - `nutritionist_id` string, uuid, nullable
    - `status` object
    - `stripe_customer_id` string, nullable
    - `payment_method` string, nullable
    - `payment_method_type` string, nullable
    - `deduction` boolean, nullable
    - `created_at` string, date-time, nullable
    - `user` PatientUserResponse
      - `id` string, uuid, nullable
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `tax_code` string, nullable
      - `home_address` string, nullable
      - `city` string, nullable
      - `province` string, nullable
      - `postal_code` string, nullable
      - `country_of_residence` string, nullable
      - `date_of_birth` string, date, nullable
      - `place_of_birth` string, nullable
      - `gender` string, nullable
      - `first_login` boolean, nullable
      - `social_provider` string, nullable
      - `how_did_you_hear_about_us` string, nullable
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
      - `registration_reason` string, nullable
      - `notes` string, nullable
      - `deletion_requested_at` string, date-time, nullable
      - `deleted_at` string, date-time, nullable
    - `psychologist` PatientOperatorResponse
      - `id` string, uuid, nullable
      - `user_id` string, uuid, nullable
      - `vat_code` string, nullable
      - `ssn_code` string, nullable
      - `tax_regime` string, nullable
      - `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
      - `call_duration` integer, nullable
      - `default_appointment_cost` number, nullable
      - `operator_cost` number, nullable
      - `presentation_video` string, nullable
      - `spoki_key` string, nullable
      - `spoki_email` string, nullable
      - `slack_user_id` string, nullable
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
      - `user` PatientUserResponse
        - `id` string, uuid, nullable
        - `first_name` string, nullable
        - `last_name` string, nullable
        - `email` string, nullable
        - `phone` string, nullable
        - `tax_code` string, nullable
        - `home_address` string, nullable
        - `city` string, nullable
        - `province` string, nullable
        - `postal_code` string, nullable
        - `country_of_residence` string, nullable
        - `date_of_birth` string, date, nullable
        - `place_of_birth` string, nullable
        - `gender` string, nullable
        - `first_login` boolean, nullable
        - `social_provider` string, nullable
        - `how_did_you_hear_about_us` string, nullable
        - `created_at` string, date-time, nullable
        - `updated_at` string, date-time, nullable
        - `registration_reason` string, nullable
        - `notes` string, nullable
        - `deletion_requested_at` string, date-time, nullable
        - `deleted_at` string, date-time, nullable
    - `nutritionist` PatientOperatorResponse
      - `id` string, uuid, nullable
      - `user_id` string, uuid, nullable
      - `vat_code` string, nullable
      - `ssn_code` string, nullable
      - `tax_regime` string, nullable
      - `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
      - `call_duration` integer, nullable
      - `default_appointment_cost` number, nullable
      - `operator_cost` number, nullable
      - `presentation_video` string, nullable
      - `spoki_key` string, nullable
      - `spoki_email` string, nullable
      - `slack_user_id` string, nullable
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
      - `user` PatientUserResponse
        - `id` string, uuid, nullable
        - `first_name` string, nullable
        - `last_name` string, nullable
        - `email` string, nullable
        - `phone` string, nullable
        - `tax_code` string, nullable
        - `home_address` string, nullable
        - `city` string, nullable
        - `province` string, nullable
        - `postal_code` string, nullable
        - `country_of_residence` string, nullable
        - `date_of_birth` string, date, nullable
        - `place_of_birth` string, nullable
        - `gender` string, nullable
        - `first_login` boolean, nullable
        - `social_provider` string, nullable
        - `how_did_you_hear_about_us` string, nullable
        - `created_at` string, date-time, nullable
        - `updated_at` string, date-time, nullable
        - `registration_reason` string, nullable
        - `notes` string, nullable
        - `deletion_requested_at` string, date-time, nullable
        - `deleted_at` string, date-time, nullable
    - `general_practitioner` GeneralPractitionerResponse
      - `id` string, uuid, nullable
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
    - `third_party_contacts` ThirdPartyContactResponse[]
      - `id` string, uuid, nullable
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `relation_role` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `is_active` boolean, nullable
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
    - `third_party_contact` ThirdPartyContactResponse
      - `id` string, uuid, nullable
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `relation_role` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `is_active` boolean, nullable
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
    - `third_party_consent` boolean
    - `coupons` ModelsSchemasPatientModelsPatientCouponResponse[]
      - `id` string, uuid, nullable
      - `patient_id` string, uuid, nullable
      - `payment_id` string, uuid, nullable
      - `stripe_coupon_id` string, nullable
      - `package_id` string, nullable
      - `package_title` string, nullable
      - `package_price` number, nullable
      - `max_sessions` integer, nullable
      - `used_sessions` integer, nullable
      - `remaining_sessions` integer, nullable
      - `status` string, nullable
      - `purchased_at` string, date-time, nullable
      - `expires_at` string, date-time, nullable
      - `last_used_at` string, date-time, nullable
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
      - `is_gift` boolean, nullable
      - `gift_purchase_id` string, uuid, nullable
      - `call_used` boolean, nullable
  - PatientNameOnlyResponse[]
    - `id` string, uuid, required
    - `user` PatientUserResponse, required
      - `id` string, uuid, nullable
      - `first_name` string, nullable
      - `last_name` string, nullable
      - `email` string, nullable
      - `phone` string, nullable
      - `tax_code` string, nullable
      - `home_address` string, nullable
      - `city` string, nullable
      - `province` string, nullable
      - `postal_code` string, nullable
      - `country_of_residence` string, nullable
      - `date_of_birth` string, date, nullable
      - `place_of_birth` string, nullable
      - `gender` string, nullable
      - `first_login` boolean, nullable
      - `social_provider` string, nullable
      - `how_did_you_hear_about_us` string, nullable
      - `created_at` string, date-time, nullable
      - `updated_at` string, date-time, nullable
      - `registration_reason` string, nullable
      - `notes` string, nullable
      - `deletion_requested_at` string, date-time, nullable
      - `deleted_at` string, date-time, 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)