Skip to content
API reference/
/Practitioners

Practitioners

List, retrieve, update, and archive practitioners within a practice group.

Operations

List Practitioners

Request

Retrieves a list of practitioners configured for online booking on Hero Health.

Security
apiKeyAuth and practiceGroupId
Query
location_idsArray of strings
appointment_type_idsArray of strings
has_availabilityboolean
searchstring

Case-insensitive partial match on the practitioner's first name, last name, the two together, or their ehr_partner_name, so a practitioner can be found either by the name patients see or by the session holder name they carry in the EHR.

include[]Array of strings

Opts additional sets of practitioners into the response. Repeatable and combinable. By default only active practitioners are returned; include[]=archived adds archived practitioners, identifiable by a non-null archived_at.

Items Value:"archived"
Example:include[]=include[]=archived
order_bystring

Field to sort by. name sorts by last name then first name, ignoring case; slot_count sorts by the number of available slots. Defaults to name.

Enum:"name""slot_count"
order_descendingstring

Sort direction. To list the practitioners with the most availability first, use order_by=slot_count&order_descending=true.

Default:"false"
Enum:"true""false"
curl -i -X GET \
  'https://developer.herohealth.net/_mock/apis/public-api/openapi/v1/practitioners?location_ids=string&appointment_type_ids=string&has_availability=true&search=string&include%5B%5D=include%5B%5D%3Darchived&order_by=name&order_descending=true' \
  -H 'x-api-key: YOUR_API_KEY_HERE' \
  -H 'x-practice-group-id: YOUR_API_KEY_HERE'

Responses

Ok

Bodyapplication/json
dataArray of objectsrequired
countnumberrequired
Response
{
  "data": [
    { … }
  ],
  "count": 0
}