# List patients

Retrieve a paginated list of patients for the account. Supports filtering by name/email and cursor-based pagination.

Endpoint: GET /partner/v2/account/{accountId}/patients
Version: 2.0
Security: PartnerOAuth

## Query parameters:

  - `firstName` (string)
    Filter patients by first name (case-insensitive contains match)
    Example: "John"

  - `lastName` (string)
    Filter patients by last name (case-insensitive contains match)
    Example: "Smith"

  - `email` (string)
    Filter patients by email (case-insensitive contains match)
    Example: "example@lobbie.com"

  - `cursor` (string)
    Pagination cursor from previous response

  - `limit` (integer)
    Number of results per page (max 100)
    Example: 20

## Path parameters:

  - `accountId` (integer, required)
    Account identifier

## Response 200 fields (application/json):

  - `nextCursor` (string)
    Opaque cursor for fetching the next page. Null if no more results.
    Example: "eyJ2Ijp7ImZpcnN0TmFtZSI6IkpvaG4ifSwiaWQiOjEyMzQ1fQ"

  - `patients` (array)
    List of patients in this page

  - `patients.dateOfBirth` (string)
    Patient's date of birth in ISO 8601 format (YYYY-MM-DD)
    Example: "1990-01-15"

  - `patients.email` (string)
    Patient's email address
    Example: "john.doe@example.com"

  - `patients.firstName` (string)
    Patient's first name
    Example: "John"

  - `patients.id` (integer)
    Unique patient identifier
    Example: 12345

  - `patients.lastName` (string)
    Patient's last name
    Example: "Doe"

  - `patients.mobilePhone` (string)
    Patient's mobile phone number (digits only, no formatting)
    Example: "14155551234"


## Response 401 fields

## Response 403 fields