Departments

A department is any place of service where a provider in a practice sees patients. This feature allows the user to retrieve and view the information of a specific department.

Was this information helpful? Yes | No What went wrong? Incomplete or incorrect information | Irrelevant Content | Others

Endpoints

Get specific department information
GET
/v1/{practiceid}/departments/{departmentid}

Retrieves detailed information of a specific department

Was this information helpful? Yes | No What went wrong? Incomplete or incorrect information | Irrelevant Content | Others
Try in Postman

Input Parameters

Expand all

❙ required

practiceid integer practiceid
departmentid integer departmentid
showalldepartments string By default, departments hidden in the portal do not appear. When this is set to true, that restriction is not applied. Default is false.
providerlist string If set to true, list providers who see patients in this department. Default is false.

Output Parameters

Expand all
address string The address for this department.
address2 string The address (line 2) for this department.
chartsharinggroupid string The chart sharing group ID puts departments (that are enabled for Clinicals) into groups with regards to clinical information. Any chart related GET calls with department IDs that are in the same chart sharing group generally return the same set of information. For example, if department IDs 1 and 2 are in chart sharing group 1000 and department IDs 20 and 21 are in chart sharing group 2000, the allergies endpoint for department ID 1 or 2 will return the same set of data, and using department IDs 20 and 21 may return a different set of allergies. Most commonly, this is used to ensure mental health and other sensitive charts remain separate from other data.
city string The city for this department.
clinicalproviderfax string This is the department's fax number for receiving orders.
clinicals string Is Clinicals turned on for this department. Possible values are "ON", "OFF", "DOCUMENTSONLY" (which means that they accept documents, but generally not doing encounters in Clinicals) or "ADMINONLY" which for most purposes is the same as "OFF", though means that it is in the middle of implementation.
communicatorbrandid string The ID of the patient-facing brand this department belongs to.
creditcardtypes string An array of credit card types accepted in this department (for retail transactions). If not present, credit cards can not be processed for this department for retail transactions.
departmentid string The department ID. This ID is local to each practice.
doesnotobservedst string Set to true if this practice does not observe daylight savings time.
ecommercecreditcardtypes string An array of credit card types accepted in this department (for ecommerce transactions). If not present, credit cards can not be processed for this department for ecommerce transactions.
fax string This is the department's fax number. Sometimes this is not configured even though the department can receive faxes. This happens when the main clinical provider has their fax number set up but the department does not. You should check both this field and the "clinicalproviderfax" field when determining if faxes are possible.
ishospitaldepartment string Flag denoting if this department is a hospital department.
latitude string The latitude may be set by the practice to correct any bad public mapping data. In degrees, with a decimal component.
longitude string The longitude may be set by the practice to correct any bad public mapping data. In degrees, with a decimal component.
medicationhistoryconsent string Should medication history consent be asked in this practice. This is a practice-wide setting at the end of the day; if it is on for one Clinicals department (of status "ON"), it will be on for all Clinicals departments.
name string The department's name.
oneyearcontractmax string For a year long payment contract, the practice's suggested maximum amount for this department.
patientdepartmentname string The patient-friendly name for this department, if set by the practice.
phone string This number is not always patient-facing; it may be a "back line".
placeofservicefacility string Is this department a "facility" or not
placeofservicetypeid string An athena-internal ID for the type of service location (e.g. office vs. hospital)
placeofservicetypename string The name describing the type of service location (e.g. office vs. hospital)
portalurl string The URL for the practice or the portal, if available, for this department. This may be the practice's website where they have a link to the portal.
providergroupid string The ID of the financial group this department belongs to. Not all practices have distinct financial groups.
providergroupname string The name of the financial group this department belongs to. Not all practices have distinct financial groups.
providerlist string If providerlist is passed in (set to true), a list of provider IDs
servicedepartment string Indicates if this is a department where billable services are performed (i.e. a department where you can create claims).
singleappointmentcontractmax string For a single appointment payment contract, the practice's suggested maximum amount for this department.
state string The state for this department.
timezone string The timezone for this department, offset from UTC/GMT.
timezonename string Timezone name of the department.
timezoneoffset string The "normal" timezone offset from UTC/GMT. The "timezone" combines this and "doesnotobservedst". During daylight savings, this is 1 less than "timezone".
zip string The zip code for this department.
Example Code