Departments Reference
The Departments reference allows the user to view the list of detailed information of departments associated with the practice.
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Endpoints
- Reference
Get list of all departments
GET
/v1/{practiceid}/departments
Retrieves detailed information of the departments associated to a practice
Was this information helpful?
Yes | No
Thank you for your feedback!
What went wrong?
Incomplete or incorrect information |
Irrelevant Content
| Others
Submit
Input Parameters
Expand all❙ required
practiceid
integer
practiceid
showalldepartments
boolean
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
boolean
If set to true, list providers who see patients in this department. Note that only providers that have booked appointments in the department will be listed. Default is false.
hospitalonly
boolean
If set to true, return hospital only departments.
fullproviderlist
boolean
If set to true, list providers who are configured to be able to see patients in this department. This list is most accurate when the department-providers configuration is actively maintained. This list is dependent on valid configuration. Warning: the configured list may be very large. Default is false.
limit
integer
Number of entries to return (default 1500, max 5000)
offset
integer
Starting point of entries; 0-indexed
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.
federaltaxid
string
This is the Federal Tax id number.
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".
typeofbill
string
This is the name of type of bill for the department.
zip
string
The zip code for this department.
Example Code