View patients (beta)

🚧

Beta

Send Nex-Api-Version: v3.1.0 to use this endpoint. It is still changing, and access is limited to approved partner institutions. Contact NexHealth before you build on it.

Changed from v3.0.0: Adds response fields data[].address, data[].address.city, data[].address.line_1, data[].address.line_2 (+15 more); removes response fields data[].bio, data[].last_sync_time.

This endpoint returns a list of patients based on the optional filters configured.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
string
required

Used to scope the request to the specified institution

int32
required

Used to scope the request to the specified location

string
Defaults to id

Optional comma-separated string of fields to sort on.
Include a leading dash for descending order.

Available fields:

  • id
  • -id
  • updated_at
  • -updated_at
string

Filter by patient name

string

Filter by patient email

string

Filter by patient phone number

date

Filter by patient date of birth. Must be a parseable date string, recommended format is YYYY-MM-DD

boolean

Filter by inactive status. When true, returns only inactive patients. When false, returns only active patients. When not specified, does not filter

string

Filter by the unique patient ID from the EHR

date-time

Only return patients updated at or after the specified date/time. Must be a parseable Date, recommended formats are YYYY-MM-DD or YYYY-MM-DDThh:mm:ss+0000

boolean

Filter by new-patient status. A new patient is a placeholder record read from the EHR for a person the practice booked without a full patient chart (its foreignid ends in np); it cannot be used to book. Once the EHR has the real patient record and NexHealth reads it, the placeholder is merged into it. true returns only new patients with an upcoming appointment, false only regular patients, unset returns regular patients plus new patients with an upcoming appointment.

boolean

Filter by non-patient status. A non-patient is a person the EHR stores without treating, such as a guarantor who is not a patient. true returns only non-patients, false leaves them out, unset returns both.

boolean

true returns only patients a completed form can be written to in the EHR. false or unset does not filter.

boolean
Defaults to false

Only returns patients belonging to the specified location, rather than searching across the EHR system

string

First item of the current page. Starts empty

string

Last item of the current page. Starts empty

int32
Defaults to 5

Number of results to return per page. Maximum allowed amount is 1000.

Headers
string
required
Defaults to v3.1.0

The NexHealth API version

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json
ChangelogMCP serverErrorsdevelopers@nexhealth.com