# Retrieve collection of patients.

Use this endpoint to retrieve the collection of patient information.

Endpoint: GET /patients
Version: 1.94.0
Security: oauth_auth_code

## Security:

  - `oauth_auth_code` (unknown)
    oauth2 scopes: read:patients

## Query parameters:

  - `page` (integer)
    The collection page number

  - `itemsPerPage` (integer)
    The number of items per page

  - `search` (string)
    Patient search

  - `expand[]` (array)

  - `uuid` (string)
    Patient uuid

  - `firstName` (string)
    Patient firstName

  - `lastName` (string)
    Patient lastName

  - `languageSpoken` (string)
    Patient languageSpoken

  - `dateOfBirth` (string)
    Patient dateOfBirth

  - `gender` (string)
    Patient gender

  - `user.email` (string)
    Patient user.email

  - `visibilityOption` (string)
    Patient visibilityOption

  - `email` (string)
    Patient email

  - `phone` (string)
    Patient phone

  - `anonymousCode` (string)
    Patient anonymousCode

  - `createdAt` (string)
    Patient createdAt

  - `updatedAt` (string)
    Patient updatedAt

  - `synchronizedAt` (string)
    Patient synchronizedAt

  - `user.uuid` (string)
    Patient user.uuid

  - `lastConsultationAt[between]` (string)
    Last consultation within the range, bounds included ("`min`..`max`"). The consultation date is the most recent recording made BY THE CALLER for that patient, the same value the lastConsultationAt property exposes. Patients the caller has no recording for are excluded as soon as this filter is used, whichever operator is passed.

  - `lastConsultationAt[gt]` (string)
    Last consultation strictly after the given date. The consultation date is the most recent recording made BY THE CALLER for that patient, the same value the lastConsultationAt property exposes. Patients the caller has no recording for are excluded as soon as this filter is used, whichever operator is passed.

  - `lastConsultationAt[gte]` (string)
    Last consultation on or after the given date. The consultation date is the most recent recording made BY THE CALLER for that patient, the same value the lastConsultationAt property exposes. Patients the caller has no recording for are excluded as soon as this filter is used, whichever operator is passed.

  - `lastConsultationAt[lt]` (string)
    Last consultation strictly before the given date. The consultation date is the most recent recording made BY THE CALLER for that patient, the same value the lastConsultationAt property exposes. Patients the caller has no recording for are excluded as soon as this filter is used, whichever operator is passed.

  - `lastConsultationAt[lte]` (string)
    Last consultation on or before the given date. The consultation date is the most recent recording made BY THE CALLER for that patient, the same value the lastConsultationAt property exposes. Patients the caller has no recording for are excluded as soon as this filter is used, whichever operator is passed.

## Response 200:

  - `200` (unknown)
    Patient collection

## Response 200 fields (application/json):

  - `uuid` (string)
    Patient unique identifier.

  - `firstName` (string | null, required)
    Patient first name.

  - `lastName` (string | null, required)
    Patient last name.

  - `languageSpoken` (string)
    Patient language.

  - `createdAt` (string)
    Patient creation date.

  - `updatedAt` (string)
    Patient update date.

  - `synchronizedAt` (string | null)
    Patient synchronization date.

  - `dateOfBirth` (string | null)
    Patient date of birth. Must be strictly before today.

  - `gender` (string | null)
    Patient gender.
    Enum: "female", "male", "unknown", "null"

  - `user` (string | null)
    Patient author.
    Example: 123e4567-e89b-12d3-a456-426614174000

  - `visibilityOption` (string | null)
    Enum: "shared", "private", "null"

  - `email` (string | null)
    Patient email address.

  - `phone` (string | null)
    Patient phone number.
    Example: +33757590893

  - `anonymousCode` (string | null)
    Patient anonymous code.

  - `recordNumber` (string | null)
    Patient record/folder number from the source software (e.g. Logosw).

  - `civility` (string | null)
    How the patient is addressed: mr | mrs | dr | pr | none. Null means nobody has declared it — clients fall back to the gender-derived form. Distinct from `gender`: a patient who is a doctor is addressed "Dr" whatever their gender.
    Enum: "mr", "mrs", "dr", "pr", "none", "null"

## Response 200 fields (application/ld+json):

  - `member` (array, required)

  - `member.@context` (any)

  - `member.@context.@vocab` (string, required)

  - `member.@context.hydra` (string, required)
    Enum: "http://www.w3.org/ns/hydra/core#"

  - `member.@id` (string, required)

  - `member.@type` (string, required)

  - `member.uuid` (string)
    Patient unique identifier.

  - `member.firstName` (string | null, required)
    Patient first name.

  - `member.lastName` (string | null, required)
    Patient last name.

  - `member.languageSpoken` (string)
    Patient language.

  - `member.createdAt` (string)
    Patient creation date.

  - `member.updatedAt` (string)
    Patient update date.

  - `member.synchronizedAt` (string | null)
    Patient synchronization date.

  - `member.dateOfBirth` (string | null)
    Patient date of birth. Must be strictly before today.

  - `member.gender` (string | null)
    Patient gender.
    Enum: "female", "male", "unknown", "null"

  - `member.user` (string | null)
    Patient author.
    Example: https://example.com/

  - `member.visibilityOption` (string | null)
    Enum: "shared", "private", "null"

  - `member.email` (string | null)
    Patient email address.

  - `member.phone` (string | null)
    Patient phone number.
    Example: +33757590893

  - `member.anonymousCode` (string | null)
    Patient anonymous code.

  - `member.recordNumber` (string | null)
    Patient record/folder number from the source software (e.g. Logosw).

  - `member.civility` (string | null)
    How the patient is addressed: mr | mrs | dr | pr | none. Null means nobody has declared it — clients fall back to the gender-derived form. Distinct from `gender`: a patient who is a doctor is addressed "Dr" whatever their gender.
    Enum: "mr", "mrs", "dr", "pr", "none", "null"

## Response 403:

  - `403` (unknown)
    Forbidden

## Response 403 fields (application/ld+json):

  - `@context` (any)

  - `@context.@vocab` (string, required)

  - `@context.hydra` (string, required)
    Enum: "http://www.w3.org/ns/hydra/core#"

  - `@id` (string, required)

  - `@type` (string, required)

  - `title` (string | null)
    A short, human-readable summary of the problem.

  - `detail` (string | null)
    A human-readable explanation specific to this occurrence of the problem.

  - `status` (integer | null)

  - `instance` (string | null)
    A URI reference that identifies the specific occurrence of the problem. It may or may not yield further information if dereferenced.

  - `type` (string)
    A URI reference that identifies the problem type

  - `description` (string | null)