Document Type - Physician Authorization

Document Type - Physician Authorization requires physician approval via signature in order to continue patient care and typically contains a space for "Physician Signature." This feature allows the user to view, modify or delete physician authorization. The feature also allows user to add or view a list of action notes for a specific physician.

Physician Authorization
Requires physician signature for approval to continue patient care and typically contains a space for 'Physician Signature.'

Approval may be required by insurance companies to continue with specific medications or equipment, or to continue care from a specialist or nursing home. Requests for provider confirmation of awareness of patient admission to a hospital can also be found here. By default, physician authorization documents are created in an open status.

Physician Authorization – Care Plan Oversight: Documentation submitted by visiting nurses, physical therapists, rehabilitation facilities, etc., regarding plans of action for patients.
Typically requires a physician's signature or approval and needs to be faxed to the sending facility.

Note: Subclassification is not necessary for this document class.

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

Endpoints

Get action notes for given physician authorization
GET
/v1/{practiceid}/documents/physicianauth/{physicianauthid}/actions

Retrieves action notes information for a specific provider authorization

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
physicianauthid integer physicianauthid
limit integer Number of entries to return (default 1500, max 5000)
offset integer Starting point of entries; 0-indexed

Output Parameters

Expand all
actionnote string The action notes that are attached to the document.
assignedto string This field will describe who was assigned this document during this document action.
createdby string The username of the person that created this document action.
createddatetime string The datetime this action note was created.
patientid integer The patient ID this document is tied to.
priority integer Priority given for this document action.
status string Status given for this document action.
Example Code
Create new action notes for given physician authorization
POST
/v1/{practiceid}/documents/physicianauth/{physicianauthid}/actions

Creates an action note for a specific physician authorization

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
physicianauthid integer physicianauthid
Content-Type string Content type of the payload

❙ Request Body

Expand all
actionnote string The new action note to add to the document.

Output Parameters

Expand all
errormessage string If there was an error with this call and SUCCESS is set to false, this field may provide additional information.
success string Returns true if the update was a success.
versiontoken string A token representing the current state of this document. Will only be set if VERSIONTOKEN was originally sent to the endpoint.
Example Code
Get list of physician authorizations for given patient
GET
/v1/{practiceid}/patients/{patientid}/documents/physicianauth

Retrieves a list of physician authorization document information for a specific patient

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
patientid integer patientid
showdeleted string By default, deleted documents are not listed. Set to list these.
status string The status of the task to filter document results.
departmentid integer The athenaNet department id.
encounterid integer Show only documents attached to this encounter.
documentsubclass string The document subclass to filter document results.
limit integer Number of entries to return (default 1500, max 5000)
offset integer Starting point of entries; 0-indexed

Output Parameters

Expand all
appointmentid integer The appointment ID for this document
assignedto string Person the document is assigned to
clinicalproviderid integer The ID of the clinical provider associated with this clinical document. Clinical providers are a master list of providers throughout the country. These include providers as well as radiology centers, labs and pharmacies.
createddate string Date the document was created. Please use createddatetime instead.
createddatetime string Date/Time (ISO 8601) the document was created
deleteddatetime string Date/time (ISO 8601) the document was deleted
departmentid string Department for the document
encounterid string Encounter ID
externalaccessionid string The external accession ID for this document. Format depends on the system the ID belongs to.
externalnote string External note for the patient.
faxnumber string The phone number to use to call back the patient.
internalaccessionid string The internal accession ID for this document. Format depends on the system the ID belongs to.
internalnote string The 'Internal Note' attached to this document
lastmodifieddatetime string Date/time (ISO 8601) the document was last modified
observationdate string
physicianauthid integer The primary key for physician authorization documents
priority string Document priority, when available. 1 is high, 2 is normal. Some labs use other numbers or characters that are lab-specific.
providerid integer Provider ID for this document
status string Status of the document
subject string Subject of the document
tietoorderid integer Order ID of the order this document is tied to, if any
Example Code
Add a physician authorization document.
POST
/v1/{practiceid}/patients/{patientid}/documents/physicianauth

Physician authorization document.

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
patientid integer patientid
Content-Type string Content type of the payload

❙ Request Body

Expand all
attachmentcontents string The file contents that will be attached to this document. PDFs are recommended.
autoclose string Documents will, normally, automatically appear in the clinical inbox for providers to review. In some cases, you might want to force the document to skip the clinical inbox, and go directly to the patient chart with a "closed" status. For that case, set this to true.
clinicalproviderid integer The ID of the external provider/lab/pharmacy associated the document.
departmentid integer The athenaNet department ID associated with the uploaded document.
faxnumber string Fax number of the sending clinical provider.
internalnote string An internal note for the provider or staff. Updating this will append to any previous notes.
priority string Priority of this result. 1 is high; 2 is normal.
providerid integer The ID of the ordering provider.

Output Parameters

Expand all
errormessage string If the operation failed, this will contain an error message.
physicianauthid integer The document ID of the new or modified document.
success string Returns true/false if the operation was successful.
Example Code
Get selected physician authorization
GET
/v1/{practiceid}/patients/{patientid}/documents/physicianauth/{physicianauthid}

Retrieves a physician authorization document record for a specific patient

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
physicianauthid integer physicianauthid
patientid integer patientid

Output Parameters

Expand all
actionnote string The most recent action note for a document
appointmentid integer The appointment ID for this document
assignedto string Person the document is assigned to
clinicalproviderid integer The ID of the clinical provider associated with this clinical document. Clinical providers are a master list of providers throughout the country. These include providers as well as radiology centers, labs and pharmacies.
createddate string Date the document was created. Please use createddatetime instead.
createddatetime string Date/Time (ISO 8601) the document was created
deleteddatetime string Date/time (ISO 8601) the document was deleted
departmentid string Department for the document
encounterid string Encounter ID
externalaccessionid string The external accession ID for this document. Format depends on the system the ID belongs to.
externalnote string External note for the patient.
faxnumber string The phone number to use to call back the patient.
internalaccessionid string The internal accession ID for this document. Format depends on the system the ID belongs to.
internalnote string The 'Internal Note' attached to this document
lastmodifieddatetime string Date/time (ISO 8601) the document was last modified
observationdatetime string Date/time the observation was taken
pages array An array of image pages associated with this document.
physicianauthid integer The primary key for physician authorization documents
priority string Document priority, when available. 1 is high, 2 is normal. Some labs use other numbers or characters that are lab-specific.
providerid integer Provider ID for this document
status string Status of the document
subject string Subject of the document
tietoorderid integer Order ID of the order this document is tied to, if any
Example Code
Delete selected physician authorization
DELETE
/v1/{practiceid}/patients/{patientid}/documents/physicianauth/{physicianauthid}

Deletes the record of a specific physician authorization

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
physicianauthid integer physicianauthid
patientid integer patientid

Output Parameters

Expand all
errormessage string If the operation failed, this will contain an error message.
physicianauthid integer The document ID of the new or modified document.
success string Returns true/false if the operation was successful.
Example Code
Get page from physician authorization document
GET
/v1/{practiceid}/patients/{patientid}/documents/physicianauth/{physicianauthid}/pages/{pageid}

Retrieves a specific page from the specific physician authorization document of the patient

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
pageid integer pageid
physicianauthid integer physicianauthid
patientid integer patientid
filesize string The file size of the document being requested.

Output Parameters

Expand all
attachment string The image of the page in jpeg format.
Example Code