# List patient summaries for a domain

Returns the patient summary view for the specified domain when the caller is authorized. Supports optional filters via query string and offset paging via skip and take.

Endpoint: GET /integrations/v1/{domain}/patients
Version: v1
Security: Bearer

## Path parameters:

  - `domain` (string, required)
    Partner domain identifier. Your bearer token is scoped to one or more domains and requests outside that scope are rejected.
    Example: "acme"

## Query parameters:

  - `firstName` (string)
    Optional patient first name filter.
    Example: "Amandeep"

  - `lastName` (string)
    Optional patient last name filter.
    Example: "KAUR"

  - `dateOfBirth` (string)
    Optional patient date of birth filter. Format is integration-specific and typically matches the QUBS date string for the domain.
    Example: "03-03-1988"

  - `email` (string)
    Optional patient email filter.
    Example: "user@example.com"

  - `mobilePhone` (string)
    Optional patient mobile phone filter.
    Example: "0435531162"

  - `skip` (integer,string)
    Optional number of items to skip. Defaults to 0 when omitted.

  - `take` (integer,string)
    Optional maximum number of items to return. Defaults to 100 when omitted.
    Example: 100

## Response 200 fields (application/json):

  - `domain` (string, required)
    Domain this patient belongs to.
    Example: "Example domain"

  - `patientId` (string, required)
    Patient identifier.
    Example: "123"

  - `patientName` (string, required)
    Patient display name.
    Example: "Example Name"

  - `firstName` (string)
    Patient first name.
    Example: "Example Name"

  - `lastName` (string)
    Patient last name.
    Example: "Example Name"

  - `gender` (string)
    Patient gender/sex string as stored in QUBS.
    Example: "Example gender"

  - `dateOfBirth` (string)
    Patient date of birth string as stored in QUBS.
    Example: "Example dateOfBirth"

## Response 400 fields (application/problem+json):

  - `type` (null,string)
    Example: "Example type"

  - `title` (null,string)
    Example: "Example title"

  - `status` (null,integer,string)
    Example: 1

  - `detail` (null,string)
    Example: "Example detail"

  - `instance` (null,string)
    Example: "Example instance"

## Response 401 fields (application/problem+json):

  - `type` (null,string)
    Example: "Example type"

  - `title` (null,string)
    Example: "Example title"

  - `status` (null,integer,string)
    Example: 1

  - `detail` (null,string)
    Example: "Example detail"

  - `instance` (null,string)
    Example: "Example instance"

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

  - `type` (null,string)
    Example: "Example type"

  - `title` (null,string)
    Example: "Example title"

  - `status` (null,integer,string)
    Example: 1

  - `detail` (null,string)
    Example: "Example detail"

  - `instance` (null,string)
    Example: "Example instance"

## Response 500 fields (application/problem+json):

  - `type` (null,string)
    Example: "Example type"

  - `title` (null,string)
    Example: "Example title"

  - `status` (null,integer,string)
    Example: 1

  - `detail` (null,string)
    Example: "Example detail"

  - `instance` (null,string)
    Example: "Example instance"