DocumentReference

A reference to a document of any kind for any purpose. Provides metadata about the document so that the document can be discovered and managed. The scope of a document is any seralized object with a mime-type, so includes formal patient centric documents (CDA), clinical notes, scanned paper, and non-patient specific documents like policy text.

http://hl7.org/fhir/us/core/STU3.1.1/StructureDefinition-us-core-documentreference.html

A Document Reference can represent many different PDFs generated in Canvas:

  • A Letter that has been faxed or printed from the patient’s chart.
  • All documents uploaded via Data Integration and linked to a Patient. This includes Lab Reports, Imaging Reports, Referral Reports, Clinical, and Administrative Documents.
  • POC Lab Commands committed on the Patient’s chart
  • Clinical Notes representing a PDF of each locked note. This also includes superseded versions on notes.
  • Any Educational Material committed on a patient’s chart.
  • Any Invoices generated for a patient.
post
/DocumentReference

DocumentReference create

Create DocumentReference with provided fields and values.

Attributes

resourceType
string

The FHIR Resource name.

extension
array[json] required

Specific FHIR extensions on this resource are supported to be able to map some Canvas specific attributes for a comment, clinical date, review mode, reviewer, priority, and if it requires a signature.

In order to identify which extension maps to specific fields in Canvas, the url field is used as an exact string match.

A few of the extensions are required:

  • clinical-date
  • reviewer
  • requires-signature
Click to view child attributes
url
string required

Identifies the meaning of the extension

Value Options Supported:
  • http://schemas.canvasmedical.com/fhir/document-reference-comment
  • http://schemas.canvasmedical.com/fhir/document-reference-clinical-date
  • http://schemas.canvasmedical.com/fhir/document-reference-review-mode
  • http://schemas.canvasmedical.com/fhir/document-reference-reviewer
  • http://schemas.canvasmedical.com/fhir/document-reference-priority
  • http://schemas.canvasmedical.com/fhir/document-reference-requires-signature
valueString
string

Value of extensions for Comment.

The valueString attribute is needed for the Comment’s extension where the url is http://schemas.canvasmedical.com/fhir/document-reference-comment.

Comment is a comment on the underlying Canvas document that is related to this DocumentReference resource.

valueCode
string

Value of extensions for Review Mode.

The valueCode attribute is needed for the Review Mode extension where the url is http://schemas.canvasmedical.com/fhir/document-reference-review-mode.

Review Mode is a field on the underlying Canvas document record which determines the review mode values (RR for Review Required, AR for Already Reviewed and RN for Review Not Required).

Value Options Supported:
  • RR
  • AR
  • RN
valueDate
date required

Value of extension for Clinical Date.

The valueDate attribute is needed for the Clinical Date extension where the url is http://schemas.canvasmedical.com/fhir/document-reference-clinical-date. This attribute is required and determines the Clinical Date on the underlying document record related to this DocumentReference resource. It’s the original_date field on the related Canvas document record. Expected date value format for this field is YYYY-MM-DD.

valueReference
json required

Value of extension for Reviewer.

The valueReference attribute is needed for expressing the Reviewer of the document where the url is http://schemas.canvasmedical.com/fhir/document-reference-reviewer. This attribute is required and will be the reference to the Practitioner (Canvas Staff) that’s assigned as the reviewer of this document.

Click to view child attributes
reference
string required

The reference string of the Practitioner in the format of "Practitioner/95b9ac2d-e963-4d7a-b165-7901870f1663".

type
string

Type the reference refers to (e.g. “Practitioner”).

valueBoolean
string required

Value of extensions for Priority and Requires Signature.

The valueBoolean attribute is needed for the Priority extension where the url is http://schemas.canvasmedical.com/fhir/document-reference-priority and for the Requires Signature where the url is http://schemas.canvasmedical.com/fhir/document-reference-requires-signature.

Priority is a field on the underlying Canvas document that is related to this DocumentReference resource and determines if the document should be prioritized. If the priority is omitted from the request, it will default to False.

Requires Signature is also a field on the underlying Canva document that determines where the related document requires Practitioner’s signature. The requires-signature extension is required on create.

status
required

The “status” field is required by FHIR to indicate the current state of the document; however, the value is ignored by Canvas on creation.

Value Options Supported:
  • current
type
json required

A coding for the type of document.

Click to view child attributes
coding
array[json] required

Code defined by a terminology system.

Click to view child attributes
system
string required

The system url of the coding.

Value Options Supported:
  • http://loinc.org
code
string required

The code value.

Value Options Supported:
  • 51852-2 (Letters) (read-only)
  • 34895-3 (Educational Material) (read-only)
  • 94093-2 (Invoices/Itemized Bill) (read-only)
  • 53243-2 (Advance Beneficiary Notice)
  • 42348-3 (Advance Directive / Living Will)
  • 91983-7 (Care Management)
  • 53245-7 (CDL (Commercial Driver License))
  • 96335-5 (Emergency Department Report)
  • 11503-0 (External Medical Records)
  • 75503-3 (Home Care Report)
  • 34105-7 (Hospital Discharge Summary)
  • 47039-3 (Hospital History & Physical)
  • 64290-0 (Insurance Card)
  • 52034-6 (Insurer Prior Authorization)
  • 34113-1 (Nursing Home)
  • 11504-8 (Operative Report)
  • 80570-5 (Patient Agreement)
  • 64285-0 (Patient Clinical Intake Form)
  • 51848-0 (Physical Exams)
  • 46209-3 (POLST (Provider Order for Life Sustaining-Treatment))
  • 64298-3 (Power of Attorney)
  • 57833-6 (Prescription Refill Request)
  • 34823-5 (Rehabilitation Report)
  • 101904-1 (Release of Information Request)
  • 34109-9 (Uncategorized Clinical Document)
  • 51851-4 (Uncategorized Administrative Document)
  • 52070-0 (Worker's Compensation Documents)
category
array[json] required

The categorization of the document.

Click to view child attributes
coding
array[json] required

Code defined by a terminology system.

Click to view child attributes
system
string required

The system url of the coding.

Value Options Supported:
  • http://schemas.canvasmedical.com/fhir/document-reference-category
code
string required

The code value.

Value Options Supported:
  • patientadministrativedocument
  • uncategorizedclinicaldocument
subject
json required

Who/what is the subject of the document.

Click to view child attributes
reference
string

The reference string of the subject in the format of "Patient/a39cafb9d1b445be95a2e2548e12a787".

type
string

Type the reference refers to (e.g. “Patient”).

author
array[json]

Who and/or what authored the document.

Click to view child attributes
reference
string required

The reference string of the author in the format of "Practitioner/0e46396e-9cbc-48c6-94cc-f75f08b66c80".

type
string

Type the reference refers to (e.g. “Practitioner”).

description
string

The title of the underlying Canvas Document related to this DocumentReference resource.

It requires standard document titles that must be matched to the document provided in the coding type attribute. See the table above with the available loinc codes and their associated description.

content
array[json] required

Document referenced

Note: There is a temporary extension on Attachment that will contain the presigned URL for the Attachment; this will be provided while we migrate to static URLs that will require bearer authentication to retrieve attachment files. Use this extension for backward-compatible URLs until the migration is completed.

Click to view child attributes
attachment
json required

Where to access the document.

Click to view child attributes
data
string required

Base64 encoded document file as a string.

Responses

201 Created
The server has successfully processed the request; the new resource has been created and is now ready for interaction.

Canvas returns the created resource's id as a UUID within the location header and a null response body.

Errors

400 Bad Request
The request was invalid or cannot be otherwise served. An accompanying error message will explain further.
401 Unauthorized
The request requires user authentication.
403 Forbidden
The request requires user authorization.
405 Method Not Allowed
The request performs an operation that is either not supported or allowed.
422 Unprocessable Entity
The request cannot be processed due to semantic issues or conflicts with the database state.
get
/DocumentReference/{id}

DocumentReference read

Read DocumentReference resource.

Path Parameters

id required
string
The unique identifier for the DocumentReference

Response Payload Attributes

resourceType
string

The FHIR Resource name.

id
string

The identifier of the document reference.

identifier
array[json]

Other identifiers for the document.

Click to view child attributes
system
string

The namespace for the identifier value.

Value Options Supported:
  • http://schemas.canvasmedical.com/fhir/document-reference-identifier
value
string

The identifier value that is unique.

extension
array[json]

Specific FHIR extensions on this resource are supported to be able to map some Canvas specific attributes for a comment, clinical date, review mode, reviewer, priority, and if it requires a signature.

Click to view child attributes
url
string

Identifies the meaning of the extension

Value Options Supported:
  • http://schemas.canvasmedical.com/fhir/document-reference-comment
  • http://schemas.canvasmedical.com/fhir/document-reference-clinical-date
  • http://schemas.canvasmedical.com/fhir/document-reference-review-mode
  • http://schemas.canvasmedical.com/fhir/document-reference-reviewer
  • http://schemas.canvasmedical.com/fhir/document-reference-priority
  • http://schemas.canvasmedical.com/fhir/document-reference-requires-signature
valueString
string

Value of extensions for Comment.

valueCode
string

Value of extensions for Review Mode.

Value Options Supported:
  • RR
  • AR
  • RN
valueDate
date

Value of extension for Clinical Date.

valueReference
json

Value of extension for Reviewer.

Click to view child attributes
reference
string

The reference string of the Practitioner in the format of "Practitioner/95b9ac2d-e963-4d7a-b165-7901870f1663".

type
string

Type the reference refers to (e.g. “Practitioner”).

valueBoolean
string

Value of extensions for Priority and Requires Signature.

status

The status of the document reference.

  • Letters and POC Lab Reports will always have a status of current.
  • Documents uploaded in Data Integration will have a status of current when created. If a document is removed from the patient’s chart, it will have a status of entered-in-error.
  • For Clinical Note documents, the status will be current if it is the latest PDF of the locked note. If it is an older version due to a practitioner unlocking/ammending the note, the status will be superseded. If the note is deleted on the patient’s chart, the status will be entered-in-error.
  • For Educational Material, the status will be current if the command is committed. If the command was entered-in-error in the chart, the status will also be entered-in-error.
  • For Invoices, the status will be current if it is a latest version or an adhoc invoice. The status will be entered-in-error if there was a problem generating or sending out the invoice to the patient. The status will be superseded if an automated invoice gets archived as it is older than the invoice interval defined Constance Config in Settings.
Value Options Supported:
  • current
  • superseded
  • entered-in-error
type
json

A coding for the type of document.

Click to view child attributes
coding
array[json]

Code defined by a terminology system.

Click to view child attributes
system
string

The system url of the coding.

Value Options Supported:
  • http://loinc.org
code
string

The code value.

Value Options Supported:
  • 51852-2 (Letters) (read-only)
  • 34895-3 (Educational Material) (read-only)
  • 94093-2 (Invoices/Itemized Bill) (read-only)
  • 53243-2 (Advance Beneficiary Notice)
  • 42348-3 (Advance Directive / Living Will)
  • 91983-7 (Care Management)
  • 53245-7 (CDL (Commercial Driver License))
  • 96335-5 (Emergency Department Report)
  • 11503-0 (External Medical Records)
  • 75503-3 (Home Care Report)
  • 34105-7 (Hospital Discharge Summary)
  • 47039-3 (Hospital History & Physical)
  • 64290-0 (Insurance Card)
  • 52034-6 (Insurer Prior Authorization)
  • 34113-1 (Nursing Home)
  • 11504-8 (Operative Report)
  • 80570-5 (Patient Agreement)
  • 64285-0 (Patient Clinical Intake Form)
  • 51848-0 (Physical Exams)
  • 46209-3 (POLST (Provider Order for Life Sustaining-Treatment))
  • 64298-3 (Power of Attorney)
  • 57833-6 (Prescription Refill Request)
  • 34823-5 (Rehabilitation Report)
  • 101904-1 (Release of Information Request)
  • 34109-9 (Uncategorized Clinical Document)
  • 51851-4 (Uncategorized Administrative Document)
  • 52070-0 (Worker's Compensation Documents)
display
string

The display name of the coding.

text
string

Plain text representation of the type of document.

category
array[json]

The categorization of the document.

Click to view child attributes
coding
array[json]

Code defined by a terminology system.

Click to view child attributes
system
string

The system url of the coding.

Value Options Supported:
  • http://schemas.canvasmedical.com/fhir/document-reference-category
code
string

The code value.

Value Options Supported:
  • clinical-note
  • correspondence
  • educationalmaterial
  • imagingreport
  • invoicefull
  • labreport
  • patientadministrativedocument
  • referralreport
  • uncategorizedclinicaldocument
subject
json

Who/what is the subject of the document.

Click to view child attributes
reference
string

The reference string of the subject in the format of "Patient/a39cafb9d1b445be95a2e2548e12a787".

type
string

Type the reference refers to (e.g. “Patient”).

date
datetime

When this document reference was created in Canvas.

author
array[json]

Who and/or what authored the document.

  • For letters, it is the practitioner who signed the letter determined by the practitioner dropdown in the UI when creating the letter.
  • For Lab Reports the author will be the practitioner who linked the report to the patient in Data Integration or if it the report has been reviewed, it will be the practitioner who committed a Lab Review. If the lab report that came through Health Gorilla was automtically linked to a Patient, there will be no author.
  • For POC Lab Reports, the author will be the practitioner who committed the command in the patient’s chart.
  • For Clinical and Administrative submitted through Data Integration, the author will be the practitioner who linked the doc to the patient in Data Integration.
  • For Educational Material docs, the author will be the practitioner who originated the command on the patient’s chart
  • For Invoices, the author will either be the practitioner who asked for the invoice when invoice was created adhoc or it will be Canvas Bot if the invoice was automtically generated.
  • There are no authors on Imaging Reports or Clinical Notes.
Click to view child attributes
reference
string

The reference string of the author in the format of "Practitioner/0e46396e-9cbc-48c6-94cc-f75f08b66c80".

type
string

Type the reference refers to (e.g. “Practitioner”).

custodian
json

Organization which maintains the document.

Click to view child attributes
reference
string

The reference string of the custodian in the format of "Organization/00000000-0000-0000-0002-000000000000".

type
string

Type the reference refers to (e.g. “Organization”).

description
string

The title of the underlying Canvas Document related to this DocumentReference resource.

content
array[json]

Document referenced

Note: There is a temporary extension on Attachment that will contain the presigned URL for the Attachment; this will be provided while we migrate to static URLs that will require bearer authentication to retrieve attachment files. Use this extension for backward-compatible URLs until the migration is completed.

Click to view child attributes
attachment
json

Where to access the document.

Click to view child attributes
contentType
string

Mime type of the content, with charset etc.

url
string

URI where the data can be found. Please note that urls may have an AWSAccessKeyId and an Expires attribute. By default documents stored in AWS S3 will expire 10 minutes after the response payload is returned.

extension
json

Extension for backward-compatible URLs

format
json

Format/content rules for the document

Click to view child attributes
system
string

The system url of the coding.

Value Options Supported:
  • http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem
code
string

The code value.

Value Options Supported:
  • urn:ihe:iti:xds:2017:mimeTypeSufficient
display
string

The display name of the coding.

Value Options Supported:
  • mimeType Sufficient
context
json

Clinical context of document.

  • For clinical note documents, the context will contain information about the encounter associated with the note if applicable.
  • For POC Lab Reports or Educational Material documents, the context will contain information about the encounter of the note the commands were committed with if applicable.
  • For Lab Reports that have a Lab Review committed in a note, the context will have information about any encounter associated with that note.
Click to view child attributes
encounter
array[json]

Context of the document content

Click to view child attributes
reference
string

The reference string of the encounter in the format of "Encounter/879b35fd-3bc2-4ccd-98d7-954dd9b6d0a9".

type
string

Type the reference refers to (e.g. “Encounter”).

period
json

Time of service that is being documented

Click to view child attributes
start
datetime

Starting time with inclusive boundary of the encounter

end
datetime

End time with inclusive boundary, if not ongoing of the encounter

Responses

200 OK
Request was successful.

Errors

401 Unauthorized
The request requires user authentication.
403 Forbidden
The request requires user authorization.
404 Not Found
The requested resource was not found.

Query Parameters

_id
string

A Canvas-issued unique identifier

category
string

Categorization of document. Filters by the code and/or system under category.coding attribute. You can search by just the code value or you can search by the system and code in the format system|code (e.g http://schemas.canvasmedical.com/fhir/document-reference-category|labreport).

date
date or datetime

Filter by the date or specific datetime the document was created. See Date Filtering for more information.

patient
string

The patient reference associated to the document in the format Patient/a39cafb9d1b445be95a2e2548e12a787.

status
string

The status of the document reference

Search Values Supported:
  • current
  • superseded
  • entered-in-error
subject
string

The patient reference associated to the document in the format Patient/a39cafb9d1b445be95a2e2548e12a787. Can be used interchangeably with the patient parameter.

type
string

Kind of document (LOINC if possible). Filters by the code and/or system under type.coding attribute. You can search by just the code value or you can search by the system and code in the format system|code (e.g http://loinc.org|11502-2).

Response Payload Attributes

resourceType
string

The FHIR Resource name.

type
string

This element and value designate that the bundle is a search response. Search result bundles will always have the Bundle.type of searchset .

total
integer

The number of resources that match the search parameter.

link
array[json]

Attributes relevant to pagination, see our Pagination page for more detail.

Click to view child attributes
relation
enum [self|first|next|last]

The relation of the page search

url

The search url for the specific relation

entry
array[json]

The results bundle that lists out each object returned in the search

Click to view child attributes
resource
json

The attributes specific to the resource type, see the Attributes section below

Attributes

resourceType
string

The FHIR Resource name.

id
string

The identifier of the document reference.

identifier
array[json]

Other identifiers for the document.

Click to view child attributes
system
string

The namespace for the identifier value.

Value Options Supported:
  • http://schemas.canvasmedical.com/fhir/document-reference-identifier
value
string

The identifier value that is unique.

extension
array[json]

Specific FHIR extensions on this resource are supported to be able to map some Canvas specific attributes for a comment, clinical date, review mode, reviewer, priority, and if it requires a signature.

Click to view child attributes
url
string

Identifies the meaning of the extension

Value Options Supported:
  • http://schemas.canvasmedical.com/fhir/document-reference-comment
  • http://schemas.canvasmedical.com/fhir/document-reference-clinical-date
  • http://schemas.canvasmedical.com/fhir/document-reference-review-mode
  • http://schemas.canvasmedical.com/fhir/document-reference-reviewer
  • http://schemas.canvasmedical.com/fhir/document-reference-priority
  • http://schemas.canvasmedical.com/fhir/document-reference-requires-signature
valueString
string

Value of extensions for Comment.

valueCode
string

Value of extensions for Review Mode.

Value Options Supported:
  • RR
  • AR
  • RN
valueDate
date

Value of extension for Clinical Date.

valueReference
json

Value of extension for Reviewer.

Click to view child attributes
reference
string

The reference string of the Practitioner in the format of "Practitioner/95b9ac2d-e963-4d7a-b165-7901870f1663".

type
string

Type the reference refers to (e.g. “Practitioner”).

valueBoolean
string

Value of extensions for Priority and Requires Signature.

status

The status of the document reference.

  • Letters and POC Lab Reports will always have a status of current.
  • Documents uploaded in Data Integration will have a status of current when created. If a document is removed from the patient’s chart, it will have a status of entered-in-error.
  • For Clinical Note documents, the status will be current if it is the latest PDF of the locked note. If it is an older version due to a practitioner unlocking/ammending the note, the status will be superseded. If the note is deleted on the patient’s chart, the status will be entered-in-error.
  • For Educational Material, the status will be current if the command is committed. If the command was entered-in-error in the chart, the status will also be entered-in-error.
  • For Invoices, the status will be current if it is a latest version or an adhoc invoice. The status will be entered-in-error if there was a problem generating or sending out the invoice to the patient. The status will be superseded if an automated invoice gets archived as it is older than the invoice interval defined Constance Config in Settings.
Value Options Supported:
  • current
  • superseded
  • entered-in-error
type
json

A coding for the type of document.

Click to view child attributes
coding
array[json]

Code defined by a terminology system.

Click to view child attributes
system
string

The system url of the coding.

Value Options Supported:
  • http://loinc.org
code
string

The code value.

Value Options Supported:
  • 51852-2 (Letters) (read-only)
  • 34895-3 (Educational Material) (read-only)
  • 94093-2 (Invoices/Itemized Bill) (read-only)
  • 53243-2 (Advance Beneficiary Notice)
  • 42348-3 (Advance Directive / Living Will)
  • 91983-7 (Care Management)
  • 53245-7 (CDL (Commercial Driver License))
  • 96335-5 (Emergency Department Report)
  • 11503-0 (External Medical Records)
  • 75503-3 (Home Care Report)
  • 34105-7 (Hospital Discharge Summary)
  • 47039-3 (Hospital History & Physical)
  • 64290-0 (Insurance Card)
  • 52034-6 (Insurer Prior Authorization)
  • 34113-1 (Nursing Home)
  • 11504-8 (Operative Report)
  • 80570-5 (Patient Agreement)
  • 64285-0 (Patient Clinical Intake Form)
  • 51848-0 (Physical Exams)
  • 46209-3 (POLST (Provider Order for Life Sustaining-Treatment))
  • 64298-3 (Power of Attorney)
  • 57833-6 (Prescription Refill Request)
  • 34823-5 (Rehabilitation Report)
  • 101904-1 (Release of Information Request)
  • 34109-9 (Uncategorized Clinical Document)
  • 51851-4 (Uncategorized Administrative Document)
  • 52070-0 (Worker's Compensation Documents)
display
string

The display name of the coding.

text
string

Plain text representation of the type of document.

category
array[json]

The categorization of the document.

Click to view child attributes
coding
array[json]

Code defined by a terminology system.

Click to view child attributes
system
string

The system url of the coding.

Value Options Supported:
  • http://schemas.canvasmedical.com/fhir/document-reference-category
code
string

The code value.

Value Options Supported:
  • clinical-note
  • correspondence
  • educationalmaterial
  • imagingreport
  • invoicefull
  • labreport
  • patientadministrativedocument
  • referralreport
  • uncategorizedclinicaldocument
subject
json

Who/what is the subject of the document.

Click to view child attributes
reference
string

The reference string of the subject in the format of "Patient/a39cafb9d1b445be95a2e2548e12a787".

type
string

Type the reference refers to (e.g. “Patient”).

date
datetime

When this document reference was created in Canvas.

author
array[json]

Who and/or what authored the document.

  • For letters, it is the practitioner who signed the letter determined by the practitioner dropdown in the UI when creating the letter.
  • For Lab Reports the author will be the practitioner who linked the report to the patient in Data Integration or if it the report has been reviewed, it will be the practitioner who committed a Lab Review. If the lab report that came through Health Gorilla was automtically linked to a Patient, there will be no author.
  • For POC Lab Reports, the author will be the practitioner who committed the command in the patient’s chart.
  • For Clinical and Administrative submitted through Data Integration, the author will be the practitioner who linked the doc to the patient in Data Integration.
  • For Educational Material docs, the author will be the practitioner who originated the command on the patient’s chart
  • For Invoices, the author will either be the practitioner who asked for the invoice when invoice was created adhoc or it will be Canvas Bot if the invoice was automtically generated.
  • There are no authors on Imaging Reports or Clinical Notes.
Click to view child attributes
reference
string

The reference string of the author in the format of "Practitioner/0e46396e-9cbc-48c6-94cc-f75f08b66c80".

type
string

Type the reference refers to (e.g. “Practitioner”).

custodian
json

Organization which maintains the document.

Click to view child attributes
reference
string

The reference string of the custodian in the format of "Organization/00000000-0000-0000-0002-000000000000".

type
string

Type the reference refers to (e.g. “Organization”).

description
string

The title of the underlying Canvas Document related to this DocumentReference resource.

content
array[json]

Document referenced

Note: There is a temporary extension on Attachment that will contain the presigned URL for the Attachment; this will be provided while we migrate to static URLs that will require bearer authentication to retrieve attachment files. Use this extension for backward-compatible URLs until the migration is completed.

Click to view child attributes
attachment
json

Where to access the document.

Click to view child attributes
contentType
string

Mime type of the content, with charset etc.

url
string

URI where the data can be found. Please note that urls may have an AWSAccessKeyId and an Expires attribute. By default documents stored in AWS S3 will expire 10 minutes after the response payload is returned.

extension
json

Extension for backward-compatible URLs

format
json

Format/content rules for the document

Click to view child attributes
system
string

The system url of the coding.

Value Options Supported:
  • http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem
code
string

The code value.

Value Options Supported:
  • urn:ihe:iti:xds:2017:mimeTypeSufficient
display
string

The display name of the coding.

Value Options Supported:
  • mimeType Sufficient
context
json

Clinical context of document.

  • For clinical note documents, the context will contain information about the encounter associated with the note if applicable.
  • For POC Lab Reports or Educational Material documents, the context will contain information about the encounter of the note the commands were committed with if applicable.
  • For Lab Reports that have a Lab Review committed in a note, the context will have information about any encounter associated with that note.
Click to view child attributes
encounter
array[json]

Context of the document content

Click to view child attributes
reference
string

The reference string of the encounter in the format of "Encounter/879b35fd-3bc2-4ccd-98d7-954dd9b6d0a9".

type
string

Type the reference refers to (e.g. “Encounter”).

period
json

Time of service that is being documented

Click to view child attributes
start
datetime

Starting time with inclusive boundary of the encounter

end
datetime

End time with inclusive boundary, if not ongoing of the encounter

Responses

200 OK
Request was successful.

Errors

400 Bad Request
The request was invalid or cannot be otherwise served. An accompanying error message will explain further.
401 Unauthorized
The request requires user authentication.
403 Forbidden
The request requires user authorization.
  • curl --request POST \
         --url 'https://fumage-example.canvasmedical.com/DocumentReference' \
         --header 'Authorization: Bearer <token>' \
         --header 'accept: application/json' \
         --header 'content-type: application/json' \
         --data '
      {
        "resourceType": "DocumentReference",
        "extension": [
            {
                "url": "http://schemas.canvasmedical.com/fhir/document-reference-comment",
                "valueString": "Some comment on Document"
            },
            {
                "url": "http://schemas.canvasmedical.com/fhir/document-reference-clinical-date",
                "valueDate": "2024-04-01"
            },
            {
                "url": "http://schemas.canvasmedical.com/fhir/document-reference-review-mode",
                "valueCode": "RN"
            },
            {
                "url": "http://schemas.canvasmedical.com/fhir/document-reference-reviewer",
                "valueReference": {
                    "reference": "Practitioner/5843991a8c934118ab4f424c839b340f",
                    "type": "Practitioner"
                }
            },
            {
                "url": "http://schemas.canvasmedical.com/fhir/document-reference-priority",
                "valueBoolean": true
            },
            {
                "url": "http://schemas.canvasmedical.com/fhir/document-reference-requires-signature",
                "valueBoolean": true
            }
        ],
        "status": "current",
        "type": {
            "coding": [
                {
                    "system": "http://loinc.org",
                    "code": "34105-7"
                }
            ]
        },
        "category": [
            {
                "coding": [
                    {
                        "system": "http://schemas.canvasmedical.com/fhir/document-reference-category",
                        "code": "uncategorizedclinicaldocument"
                    }
                ]
            }
        ],
        "subject": {
            "reference": "Patient/aabcf98215eb4356ad773a0ec9cd3369",
            "type": "Patient"
        },
        "author": [
            {
                "reference": "Practitioner/4150cd20de8a470aa570a852859ac87e",
                "type": "Practitioner"
            }
        ],
        "description": "Hospital Discharge Summary",
        "content": [
            {
                "attachment": {
                    "contentType": "application/pdf",
                    "data": "JVBERi0xLjIgCjkgMCBvYmoKPDwKPj4Kc3RyZWFtCkJULyAzMiBUZiggIFlPVVIgVEVYVCBIRVJFICAgKScgRVQKZW5kc3RyZWFtCmVuZG9iago0IDAgb2JqCjw8Ci9UeXBlIC9QYWdlCi9QYXJlbnQgNSAwIFIKL0NvbnRlbnRzIDkgMCBSCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9LaWRzIFs0IDAgUiBdCi9Db3VudCAxCi9UeXBlIC9QYWdlcwovTWVkaWFCb3ggWyAwIDAgMjUwIDUwIF0KPj4KZW5kb2JqCjMgMCBvYmoKPDwKL1BhZ2VzIDUgMCBSCi9UeXBlIC9DYXRhbG9nCj4+CmVuZG9iagp0cmFpbGVyCjw8Ci9Sb290IDMgMCBSCj4+CiUlRU9G"
                }
            }
        ]
      }
    }'
    
  • import requests
    
    url = "https://fumage-example.canvasmedical.com/DocumentReference"
    
    headers = {
        "accept": "application/json",
        "Authorization": "Bearer <token>",
        "content-type": "application/json",
    }
    
    payload = {
        "resourceType": "DocumentReference",
        "extension": [
            {
                "url": "http://schemas.canvasmedical.com/fhir/document-reference-comment",
                "valueString": "Some comment on Document",
            },
            {
                "url": "http://schemas.canvasmedical.com/fhir/document-reference-clinical-date",
                "valueDate": "2024-04-01",
            },
            {
                "url": "http://schemas.canvasmedical.com/fhir/document-reference-review-mode",
                "valueCode": "RN",
            },
            {
                "url": "http://schemas.canvasmedical.com/fhir/document-reference-reviewer",
                "valueReference": {
                    "reference": "Practitioner/5843991a8c934118ab4f424c839b340f",
                    "type": "Practitioner",
                }
            },
            {
                "url": "http://schemas.canvasmedical.com/fhir/document-reference-priority",
                "valueBoolean": true,
            },
            {
                "url": "http://schemas.canvasmedical.com/fhir/document-reference-requires-signature",
                "valueBoolean": true,
            }
        ],
        "status": "current",
        "type": {
            "coding": [
                {
                    "system": "http://loinc.org",
                    "code": "34105-7",
                }
            ]
        },
        "category": [
            {
                "coding": [
                    {
                        "system": "http://schemas.canvasmedical.com/fhir/document-reference-category",
                        "code": "uncategorizedclinicaldocument",
                    }
                ]
            }
        ],
        "subject": {
            "reference": "Patient/aabcf98215eb4356ad773a0ec9cd3369",
            "type": "Patient",
        },
        "author": [
            {
                "reference": "Practitioner/4150cd20de8a470aa570a852859ac87e",
                "type": "Practitioner",
            }
        ],
        "description": "Hospital Discharge Summary",
        "content": [
            {
                "attachment": {
                    "contentType": "application/pdf",
                    "data": "JVBERi0xLjIgCjkgMCBvYmoKPDwKPj4Kc3RyZWFtCkJULyAzMiBUZiggIFlPVVIgVEVYVCBIRVJFICAgKScgRVQKZW5kc3RyZWFtCmVuZG9iago0IDAgb2JqCjw8Ci9UeXBlIC9QYWdlCi9QYXJlbnQgNSAwIFIKL0NvbnRlbnRzIDkgMCBSCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9LaWRzIFs0IDAgUiBdCi9Db3VudCAxCi9UeXBlIC9QYWdlcwovTWVkaWFCb3ggWyAwIDAgMjUwIDUwIF0KPj4KZW5kb2JqCjMgMCBvYmoKPDwKL1BhZ2VzIDUgMCBSCi9UeXBlIC9DYXRhbG9nCj4+CmVuZG9iagp0cmFpbGVyCjw8Ci9Sb290IDMgMCBSCj4+CiUlRU9G",
                }
            }
        ]
    }
    
  • null
    
  • {
      "resourceType": "OperationOutcome",
      "issue": [
        {
          "severity": "error",
          "code": "invalid",
          "details": {
            "text": "Bad request"
          }
        }
      ]
    }
    
  • {
      "resourceType": "OperationOutcome",
      "issue": [
        {
          "severity": "error",
          "code": "unknown",
          "details": {
            "text": "Authentication failed"
          }
        }
      ]
    }
    
  • {
      "resourceType": "OperationOutcome",
      "issue": [
        {
          "severity": "error",
          "code": "forbidden",
          "details": {
            "text": "Authorization failed"
          }
        }
      ]
    }
    
  • {
      "resourceType": "OperationOutcome",
      "issue": [
        {
          "severity": "error",
          "code": "not-supported",
          "details": {
            "text": "Operation is not supported"
          }
        }
      ]
    }
    
  • {
      "resourceType": "OperationOutcome",
      "issue": [
        {
          "severity": "error",
          "code": "business-rule",
          "details": {
            "text": "Unprocessable entity"
          }
        }
      ]
    }
    
  • curl --request GET \
         --url 'https://fumage-example.canvasmedical.com/DocumentReference/<id>' \
         --header 'Authorization: Bearer <token>' \
         --header 'accept: application/json'
    
  • import requests
    
    url = "https://fumage-example.canvasmedical.com/DocumentReference/<id>"
    
    headers = {
        "accept": "application/json",
        "Authorization": "Bearer <token>"
    }
    
    response = requests.get(url, headers=headers)
    
    print(response.text)
    
  • {
        "resourceType": "DocumentReference",
        "id": "6f60ed1c-a6b3-4791-99f0-f618704e33d1",
        "extension": [
            {
                "url": "http://schemas.canvasmedical.com/fhir/document-reference-comment",
                "valueString": "Some comment on Document"
            },
            {
                "url": "http://schemas.canvasmedical.com/fhir/document-reference-clinical-date",
                "valueDate": "2024-04-01"
            },
            {
                "url": "http://schemas.canvasmedical.com/fhir/document-reference-review-mode",
                "valueCode": "RN"
            },
            {
                "url": "http://schemas.canvasmedical.com/fhir/document-reference-reviewer",
                "valueReference": {
                    "reference": "Practitioner/5843991a8c934118ab4f424c839b340f",
                    "type": "Practitioner"
                }
            },
            {
                "url": "http://schemas.canvasmedical.com/fhir/document-reference-priority",
                "valueBoolean": true
            },
            {
                "url": "http://schemas.canvasmedical.com/fhir/document-reference-requires-signature",
                "valueBoolean": true
            }
        ],
        "status": "current",
        "type": {
            "coding": [
                {
                    "system": "http://loinc.org",
                    "code": "34105-7",
                    "display": "Hospital Discharge summary"
                }
            ]
        },
        "category": [
            {
                "coding": [
                    {
                        "system": "http://schemas.canvasmedical.com/fhir/document-reference-category",
                        "code": "uncategorizedclinicaldocument"
                    }
                ]
            }
        ],
        "subject": {
            "reference": "Patient/aabcf98215eb4356ad773a0ec9cd3369",
            "type": "Patient"
        },
        "date": "2024-04-22T00:00:00+00:00",
        "author": [
            {
                "reference": "Practitioner/4150cd20de8a470aa570a852859ac87e",
                "type": "Practitioner"
            }
        ],
        "custodian": {
            "reference": "Organization/00000000-0000-0000-0002-000000000000",
            "type": "Organization"
        },
        "description": "Hospital Discharge Summary",
        "content": [
            {
                "attachment": {
                    "extension": [
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/extensions/deprecated-url",
                            "valueUri": "https://canvas-client-media.s3.amazonaws.com/training/invoices/f3d750f5d77d403c96baef6a6055c6e7_20211027_193132.pdf?AWSAccessKeyId=xxxx&Signature=xxxx&Expires=xxxx"
                        }
                    ],
                    "contentType": "application/pdf",
                    "url": "https://fumage-example.canvasmedical.com/DocumentReference/6f60ed1c-a6b3-4791-99f0-f618704e33d1/files/content"
                },
                "format": {
                    "system": "http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem",
                    "code": "urn:ihe:iti:xds:2017:mimeTypeSufficient",
                    "display": "mimeType Sufficient"
                }
            }
        ]
    }
    
  • {
      "resourceType": "OperationOutcome",
      "issue": [
        {
          "severity": "error",
          "code": "unknown",
          "details": {
            "text": "Authentication failed"
          }
        }
      ]
    }
    
  • {
      "resourceType": "OperationOutcome",
      "issue": [
        {
          "severity": "error",
          "code": "forbidden",
          "details": {
            "text": "Authorization failed"
          }
        }
      ]
    }
    
  • {
      "resourceType": "OperationOutcome",
      "issue": [
        {
          "severity": "error",
          "code": "not-found",
          "details": {
            "text": "Unknown DocumentReference resource '9b814d81-fb56-456b-a46d-c67fdaaec2ac'"
          }
        }
      ]
    }
    
  • curl --request GET \
         --url 'https://fumage-example.canvasmedical.com/DocumentReference?subject=Patient/cfd91cd3bd9046db81199aa8ee4afd7f&status=current&type=http://loinc.org|11502-2' \
         --header 'Authorization: Bearer <token>' \
         --header 'accept: application/json'
    
  • import requests
    
    url = "https://fumage-example.canvasmedical.com/DocumentReference?subject=Patient/cfd91cd3bd9046db81199aa8ee4afd7f&status=current&type=http://loinc.org|11502-2"
    
    headers = {
        "accept": "application/json",
        "Authorization": "Bearer <token>"
    }
    
    response = requests.get(url, headers=headers)
    
    print(response.text)
    
  • {
        "resourceType": "Bundle",
        "type": "searchset",
        "total": 12,
        "link": [
            {
                "relation": "self",
                "url": "/DocumentReference?patient=Patient/c0df2c04a0e64b46ba7fe3f836068e49&_count=50&_offset=0"
            },
            {
                "relation": "first",
                "url": "/DocumentReference?patient=Patient/c0df2c04a0e64b46ba7fe3f836068e49&_count=50&_offset=0"
            },
            {
                "relation": "last",
                "url": "/DocumentReference?patient=Patient/c0df2c04a0e64b46ba7fe3f836068e49&_count=50&_offset=0"
            }
        ],
        "entry": [
            {
                "resource": {
                    "resourceType": "DocumentReference",
                    "id": "4b640065-ae64-4775-b5a8-8264314cf5fc",
                    "status": "current",
                    "type": {
                        "coding": [
                            {
                                "system": "http://loinc.org",
                                "code": "94093-2",
                                "display": "Itemized bill"
                            }
                        ],
                        "text": "Itemized bill"
                    },
                    "category": [
                        {
                            "coding": [
                                {
                                    "system": "http://schemas.canvasmedical.com/fhir/document-reference-category",
                                    "code": "invoicefull"
                                }
                            ]
                        }
                    ],
                    "subject": {
                        "reference": "Patient/c0df2c04a0e64b46ba7fe3f836068e49",
                        "type": "Patient"
                    },
                    "date": "2024-02-24T00:00:00+00:00",
                    "author": [
                        {
                            "reference": "Practitioner/5eede137ecfe4124b8b773040e33be14",
                            "type": "Practitioner"
                        }
                    ],
                    "custodian": {
                        "reference": "Organization/00000000-0000-0000-0002-000000000000",
                        "type": "Organization"
                    },
                    "description": "Itemized bill",
                    "content": [
                        {
                            "attachment": {
                                "extension": [
                                    {
                                        "url": "http://schemas.canvasmedical.com/fhir/extensions/deprecated-url",
                                        "valueUri": "https://canvas-client-media.s3.amazonaws.com/training/invoices/c0df2c04a0e64b46ba7fe3f836068e49_20240224_124702.pdf?AWSAccessKeyId=AKIAQB7SIDR7EI2V32FZ&Signature=WtfvJWbBgc50VgekeqrUDTPsyHk%3D&Expires=1709072108"
                                    }
                                ],
                                "contentType": "application/pdf",
                                "url": "https://fumage-example.canvasmedical.com/DocumentReference/4b640065-ae64-4775-b5a8-8264314cf5fc/files/content"
                            },
                            "format": {
                                "system": "http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem",
                                "code": "urn:ihe:iti:xds:2017:mimeTypeSufficient",
                                "display": "mimeType Sufficient"
                            }
                        }
                    ]
                }
            },
            {
                "resource": {
                    "resourceType": "DocumentReference",
                    "id": "5a0cf7ae-bd88-4f04-bd7e-60a33e5e2824",
                    "extension": [
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-comment",
                            "valueString": "Some comment on LabReport Document"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-clinical-date",
                            "valueDate": "2024-04-02"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-review-mode",
                            "valueCode": "AR"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-reviewer",
                            "valueReference": {
                                "reference": "Practitioner/5843991a8c934118ab4f424c839b340f",
                                "type": "Practitioner"
                            }
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-requires-signature",
                            "valueBoolean": true
                        }
                    ],
                    "status": "current",
                    "type": {
                        "coding": [
                            {
                                "system": "http://loinc.org",
                                "code": "11502-2",
                                "display": "Laboratory report"
                            }
                        ],
                        "text": "Laboratory report"
                    },
                    "category": [
                        {
                            "coding": [
                                {
                                    "system": "http://schemas.canvasmedical.com/fhir/document-reference-category",
                                    "code": "labreport"
                                }
                            ]
                        }
                    ],
                    "subject": {
                        "reference": "Patient/c0df2c04a0e64b46ba7fe3f836068e49",
                        "type": "Patient"
                    },
                    "date": "2024-04-22T00:00:00+00:00",
                    "author": [
                        {
                            "reference": "Practitioner/4150cd20de8a470aa570a852859ac87e",
                            "type": "Practitioner"
                        }
                    ],
                    "custodian": {
                        "reference": "Organization/00000000-0000-0000-0002-000000000000",
                        "type": "Organization"
                    },
                    "description": "Lab Report",
                    "content": [
                        {
                            "attachment": {
                                "extension": [
                                    {
                                        "url": "http://schemas.canvasmedical.com/fhir/extensions/deprecated-url",
                                        "valueUri": "https://canvas-client-media.s3.amazonaws.com/training/dummy_BLseNPP.pdf?AWSAccessKeyId=AKIAQB7SIDR7EI2V32FZ&Signature=uBuEZpbxcCg4w9hZ6hAXLJxMGe8%3D&Expires=1709072108"
                                    }
                                ],
                                "contentType": "application/pdf",
                                "url": "https://fumage-example.canvasmedical.com/DocumentReference/5a0cf7ae-bd88-4f04-bd7e-60a33e5e2824/files/content"
                            },
                            "format": {
                                "system": "http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem",
                                "code": "urn:ihe:iti:xds:2017:mimeTypeSufficient",
                                "display": "mimeType Sufficient"
                            }
                        }
                    ],
                    "context": {
                        "encounter": [
                            {
                                "reference": "Encounter/879b35fd-3bc2-4ccd-98d7-954dd9b6d0a9",
                                "type": "Encounter"
                            }
                        ],
                        "period": {
                            "start": "2024-02-22T23:10:12.409838+00:00"
                        }
                    }
                }
            },
            {
                "resource": {
                    "resourceType": "DocumentReference",
                    "id": "b9f82cd0-6644-4b3f-a9d1-7585c3e71498",
                    "extension": [
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-comment",
                            "valueString": "Some comment on ImagingReport Document"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-clinical-date",
                            "valueDate": "2024-04-03"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-review-mode",
                            "valueCode": "RN"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-reviewer",
                            "valueReference": {
                                "reference": "Practitioner/5843991a8c934118ab4f424c839b340f",
                                "type": "Practitioner"
                            }
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-requires-signature",
                            "valueBoolean": true
                        }
                    ],
                    "status": "entered-in-error",
                    "type": {
                        "coding": [
                            {
                                "system": "http://loinc.org",
                                "code": "18748-4",
                                "display": "Diagnostic imaging study"
                            }
                        ],
                        "text": "Diagnostic imaging study"
                    },
                    "category": [
                        {
                            "coding": [
                                {
                                    "system": "http://schemas.canvasmedical.com/fhir/document-reference-category",
                                    "code": "imagingreport"
                                }
                            ]
                        }
                    ],
                    "subject": {
                        "reference": "Patient/c0df2c04a0e64b46ba7fe3f836068e49",
                        "type": "Patient"
                    },
                    "date": "2024-04-21T00:00:00+00:00",
                    "custodian": {
                        "reference": "Organization/00000000-0000-0000-0002-000000000000",
                        "type": "Organization"
                    },
                    "description": "Imaging Report",
                    "content": [
                        {
                            "attachment": {
                                "extension": [
                                    {
                                        "url": "http://schemas.canvasmedical.com/fhir/extensions/deprecated-url",
                                        "valueUri": "https://canvas-client-media.s3.amazonaws.com/training/document_annotations/blob_FeMcbYv?AWSAccessKeyId=AKIAQB7SIDR7EI2V32FZ&Signature=7V8KwSeZlPCCJiiarAHK55IW4pI%3D&Expires=1709072108"
                                    }
                                ],
                                "contentType": "application/pdf",
                                "url": "https://fumage-example.canvasmedical.com/DocumentReference/b9f82cd0-6644-4b3f-a9d1-7585c3e71498/files/content"
                            },
                            "format": {
                                "system": "http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem",
                                "code": "urn:ihe:iti:xds:2017:mimeTypeSufficient",
                                "display": "mimeType Sufficient"
                            }
                        }
                    ]
                }
            }
            {
                "resource": {
                    "resourceType": "DocumentReference",
                    "id": "51a49fef-eb67-4b8d-a992-b3dd9e754dea",
                    "status": "current",
                    "type": {
                        "coding": [
                            {
                                "system": "http://loinc.org",
                                "code": "51852-2",
                                "display": "Letter"
                            }
                        ],
                        "text": "Letter"
                    },
                    "category": [
                        {
                            "coding": [
                                {
                                    "system": "http://schemas.canvasmedical.com/fhir/document-reference-category",
                                    "code": "correspondence"
                                }
                            ]
                        }
                    ],
                    "subject": {
                        "reference": "Patient/c0df2c04a0e64b46ba7fe3f836068e49",
                        "type": "Patient"
                    },
                    "date": "2024-02-21T00:00:00+00:00",
                    "author": [
                        {
                            "reference": "Practitioner/4150cd20de8a470aa570a852859ac87e",
                            "type": "Practitioner"
                        }
                    ],
                    "custodian": {
                        "reference": "Organization/00000000-0000-0000-0002-000000000000",
                        "type": "Organization"
                    },
                    "description": "Letter",
                    "content": [
                        {
                            "attachment": {
                                "extension": [
                                    {
                                        "url": "http://schemas.canvasmedical.com/fhir/extensions/deprecated-url",
                                        "valueUri": "https://canvas-client-media.s3.amazonaws.com/training/generic_documents/letter_494.pdf?AWSAccessKeyId=AKIAQB7SIDR7EI2V32FZ&Signature=K4d67C%2FNj9PtLIjY9by5qLwYiK4%3D&Expires=1709072108"
                                    }
                                ],
                                "contentType": "application/pdf",
                                "url": "https://fumage-example.canvasmedical.com/DocumentReference/51a49fef-eb67-4b8d-a992-b3dd9e754dea/files/content"
                            },
                            "format": {
                                "system": "http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem",
                                "code": "urn:ihe:iti:xds:2017:mimeTypeSufficient",
                                "display": "mimeType Sufficient"
                            }
                        }
                    ]
                }
            },
            {
                "resource": {
                    "resourceType": "DocumentReference",
                    "id": "713394da-f250-4c59-8b47-96458155f687",
                    "status": "entered-in-error",
                    "category": [
                        {
                            "coding": [
                                {
                                    "system": "http://schemas.canvasmedical.com/fhir/document-reference-category",
                                    "code": "clinical-note"
                                }
                            ]
                        }
                    ],
                    "subject": {
                        "reference": "Patient/c0df2c04a0e64b46ba7fe3f836068e49",
                        "type": "Patient"
                    },
                    "date": "2024-02-22T00:00:00+00:00",
                    "custodian": {
                        "reference": "Organization/00000000-0000-0000-0002-000000000000",
                        "type": "Organization"
                    },
                    "content": [
                        {
                            "attachment": {
                                "extension": [
                                    {
                                        "url": "http://schemas.canvasmedical.com/fhir/extensions/deprecated-url",
                                        "valueUri": "https://canvas-client-media.s3.amazonaws.com/training/note_history/training_note_state_document_232604_1708628478?AWSAccessKeyId=AKIAQB7SIDR7EI2V32FZ&Signature=yangPOcYiWvr48s6VhvQIBSw0fs%3D&Expires=1709072108"
                                    }
                                ],
                                "contentType": "application/pdf",
                                "url": "https://fumage-example.canvasmedical.com/DocumentReference/713394da-f250-4c59-8b47-96458155f687/files/content"
                            },
                            "format": {
                                "system": "http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem",
                                "code": "urn:ihe:iti:xds:2017:mimeTypeSufficient",
                                "display": "mimeType Sufficient"
                            }
                        }
                    ],
                    "description": "Lab visit",
                    "context": {
                        "encounter": [
                            {
                                "reference": "Encounter/aaefb326-8601-4c03-84d4-d6151b3a96bf",
                                "type": "Encounter"
                            }
                        ],
                        "period": {
                            "start": "2024-02-21T21:52:42.777590+00:00",
                            "end": "2024-02-22T19:37:10.850120+00:00"
                        }
                    }
                }
            },
            {
                "resource": {
                    "resourceType": "DocumentReference",
                    "id": "6ebf590d-ff90-412e-a5e7-9be30d6e4c35",
                    "status": "current",
                    "type": {
                        "coding": [
                            {
                                "system": "http://loinc.org",
                                "code": "11488-4",
                                "display": "Consult note"
                            }
                        ],
                        "text": "Consult note"
                    },
                    "category": [
                        {
                            "coding": [
                                {
                                    "system": "http://schemas.canvasmedical.com/fhir/document-reference-category",
                                    "code": "referralreport"
                                }
                            ]
                        }
                    ],
                    "subject": {
                        "reference": "Patient/c0df2c04a0e64b46ba7fe3f836068e49",
                        "type": "Patient"
                    },
                    "date": "2024-02-22T00:00:00+00:00",
                    "author": [
                        {
                            "reference": "Practitioner/5eede137ecfe4124b8b773040e33be14",
                            "type": "Practitioner"
                        }
                    ],
                    "custodian": {
                        "reference": "Organization/00000000-0000-0000-0002-000000000000",
                        "type": "Organization"
                    },
                    "description": "Consultancy Report",
                    "content": [
                        {
                            "attachment": {
                                "extension": [
                                    {
                                        "url": "http://schemas.canvasmedical.com/fhir/extensions/deprecated-url",
                                        "valueUri": "https://canvas-client-media.s3.amazonaws.com/training/dummy_BLseNPP.pdf?AWSAccessKeyId=AKIAQB7SIDR7EI2V32FZ&Signature=uBuEZpbxcCg4w9hZ6hAXLJxMGe8%3D&Expires=1709072108"
                                    }
                                ],
                                "contentType": "application/pdf",
                                "url": "https://fumage-example.canvasmedical.com/DocumentReference/6ebf590d-ff90-412e-a5e7-9be30d6e4c35/files/content"
                            },
                            "format": {
                                "system": "http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem",
                                "code": "urn:ihe:iti:xds:2017:mimeTypeSufficient",
                                "display": "mimeType Sufficient"
                            }
                        }
                    ]
                }
            },
            {
                "resource": {
                    "resourceType": "DocumentReference",
                    "id": "d9a1304d-159d-4518-be88-3f9a1ea93cd1",
                    "extension": [
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-comment",
                            "valueString": "Disability form comment"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-clinical-date",
                            "valueDate": "2023-12-12"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-review-mode",
                            "valueCode": "RN"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-reviewer",
                            "valueReference": {
                                "reference": "Practitioner/4150cd20de8a470aa570a852859ac87e",
                                "type": "Practitioner"
                            }
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-priority",
                            "valueBoolean": false
                        }
                    ],
                    "status": "current",
                    "type": {
                        "text": "Disability Form"
                    },
                    "category": [
                        {
                            "coding": [
                                {
                                    "system": "http://schemas.canvasmedical.com/fhir/document-reference-category",
                                    "code": "patientadministrativedocument"
                                }
                            ]
                        }
                    ],
                    "subject": {
                        "reference": "Patient/c0df2c04a0e64b46ba7fe3f836068e49",
                        "type": "Patient"
                    },
                    "date": "2024-02-22T00:00:00+00:00",
                    "author": [
                        {
                            "reference": "Practitioner/5eede137ecfe4124b8b773040e33be14",
                            "type": "Practitioner"
                        }
                    ],
                    "custodian": {
                        "reference": "Organization/00000000-0000-0000-0002-000000000000",
                        "type": "Organization"
                    },
                    "description": "Disability Form",
                    "content": [
                        {
                            "attachment": {
                                "extension": [
                                    {
                                        "url": "http://schemas.canvasmedical.com/fhir/extensions/deprecated-url",
                                        "valueUri": "https://canvas-client-media.s3.amazonaws.com/training/dummy_BLseNPP.pdf?AWSAccessKeyId=AKIAQB7SIDR7EI2V32FZ&Signature=uBuEZpbxcCg4w9hZ6hAXLJxMGe8%3D&Expires=1709072108"
                                    }
                                ],
                                "contentType": "application/pdf",
                                "url": "https://fumage-example.canvasmedical.com/DocumentReference/d9a1304d-159d-4518-be88-3f9a1ea93cd1/files/content"
                            },
                            "format": {
                                "system": "http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem",
                                "code": "urn:ihe:iti:xds:2017:mimeTypeSufficient",
                                "display": "mimeType Sufficient"
                            }
                        }
                    ]
                }
            },
            {
                "resource": {
                    "resourceType": "DocumentReference",
                    "id": "bce56cc4-268a-4562-a699-16e8869415ad",
                    "extension": [
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-comment",
                            "valueString": "Hospital discharge summary comment"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-clinical-date",
                            "valueDate": "2024-01-14"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-review-mode",
                            "valueCode": "AR"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-reviewer",
                            "valueReference": {
                                "reference": "Practitioner/4150cd20de8a470aa570a852859ac87e",
                                "type": "Practitioner"
                            }
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-priority",
                            "valueBoolean": true
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-requires-signature",
                            "valueBoolean": false
                        }
                    ],
                    "status": "current",
                    "type": {
                        "coding": [
                            {
                                "system": "http://loinc.org",
                                "code": "34105-7",
                                "display": "Hospital Discharge summary"
                            }
                        ],
                        "text": "Hospital Discharge summary"
                    },
                    "category": [
                        {
                            "coding": [
                                {
                                    "system": "http://schemas.canvasmedical.com/fhir/document-reference-category",
                                    "code": "uncategorizedclinicaldocument"
                                }
                            ]
                        }
                    ],
                    "subject": {
                        "reference": "Patient/c0df2c04a0e64b46ba7fe3f836068e49",
                        "type": "Patient"
                    },
                    "date": "2024-02-22T00:00:00+00:00",
                    "author": [
                        {
                            "reference": "Practitioner/fdb06c59cecd43d095884222fcd93717",
                            "type": "Practitioner"
                        }
                    ],
                    "custodian": {
                        "reference": "Organization/00000000-0000-0000-0002-000000000000",
                        "type": "Organization"
                    },
                    "description": "Hospital Discharge Summary",
                    "content": [
                        {
                            "attachment": {
                                "extension": [
                                    {
                                        "url": "http://schemas.canvasmedical.com/fhir/extensions/deprecated-url",
                                        "valueUri": "https://canvas-client-media.s3.amazonaws.com/training/dummy_BLseNPP.pdf?AWSAccessKeyId=AKIAQB7SIDR7EI2V32FZ&Signature=uBuEZpbxcCg4w9hZ6hAXLJxMGe8%3D&Expires=1709072108"
                                    }
                                ],
                                "contentType": "application/pdf",
                                "url": "https://fumage-example.canvasmedical.com/DocumentReference/bce56cc4-268a-4562-a699-16e8869415ad/files/content"
                            },
                            "format": {
                                "system": "http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem",
                                "code": "urn:ihe:iti:xds:2017:mimeTypeSufficient",
                                "display": "mimeType Sufficient"
                            }
                        }
                    ]
                }
            },
            {
                "resource": {
                    "resourceType": "DocumentReference",
                    "id": "d220fa24-2b2f-44cf-9843-5a1b681f0805",
                    "extension": [
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-comment",
                            "valueString": "Advance beneficiary comment"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-clinical-date",
                            "valueDate": "2024-02-13"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-review-mode",
                            "valueCode": "RN"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-reviewer",
                            "valueReference": {
                                "reference": "Practitioner/4150cd20de8a470aa570a852859ac87e",
                                "type": "Practitioner"
                            }
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-priority",
                            "valueBoolean": true
                        }
                    ],
                    "status": "current",
                    "type": {
                        "coding": [
                            {
                                "system": "http://loinc.org",
                                "code": "53243-2",
                                "display": "Advanced beneficiary notice"
                            }
                        ],
                        "text": "Advanced beneficiary notice"
                    },
                    "category": [
                        {
                            "coding": [
                                {
                                    "system": "http://schemas.canvasmedical.com/fhir/document-reference-category",
                                    "code": "patientadministrativedocument"
                                }
                            ]
                        }
                    ],
                    "subject": {
                        "reference": "Patient/c0df2c04a0e64b46ba7fe3f836068e49",
                        "type": "Patient"
                    },
                    "date": "2024-02-22T00:00:00+00:00",
                    "author": [
                        {
                            "reference": "Practitioner/5eede137ecfe4124b8b773040e33be14",
                            "type": "Practitioner"
                        }
                    ],
                    "custodian": {
                        "reference": "Organization/00000000-0000-0000-0002-000000000000",
                        "type": "Organization"
                    },
                    "description": "Advanced Beneficiary Notice",
                    "content": [
                        {
                            "attachment": {
                                "extension": [
                                    {
                                        "url": "http://schemas.canvasmedical.com/fhir/extensions/deprecated-url",
                                        "valueUri": "https://canvas-client-media.s3.amazonaws.com/training/dummy_BLseNPP.pdf?AWSAccessKeyId=AKIAQB7SIDR7EI2V32FZ&Signature=uBuEZpbxcCg4w9hZ6hAXLJxMGe8%3D&Expires=1709072108"
                                    }
                                ],
                                "contentType": "application/pdf",
                                "url": "https://fumage-example.canvasmedical.com/DocumentReference/d220fa24-2b2f-44cf-9843-5a1b681f0805/files/content"
                            },
                            "format": {
                                "system": "http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem",
                                "code": "urn:ihe:iti:xds:2017:mimeTypeSufficient",
                                "display": "mimeType Sufficient"
                            }
                        }
                    ]
                }
            },
            {
                "resource": {
                    "resourceType": "DocumentReference",
                    "id": "04a71b54-89b0-49bf-96be-60b5bdfa6450",
                    "extension": [
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-comment",
                            "valueString": "Handicap Parking Permit comment"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-clinical-date",
                            "valueDate": "2024-04-01"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-review-mode",
                            "valueCode": "RN"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-reviewer",
                            "valueReference": {
                                "reference": "Practitioner/4150cd20de8a470aa570a852859ac87e",
                                "type": "Practitioner"
                            }
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-priority",
                            "valueBoolean": true
                        }
                    ],
                    "status": "current",
                    "type": {
                        "text": "Handicap Parking Permit"
                    },
                    "category": [
                        {
                            "coding": [
                                {
                                    "system": "http://schemas.canvasmedical.com/fhir/document-reference-category",
                                    "code": "patientadministrativedocument"
                                }
                            ]
                        }
                    ],
                    "subject": {
                        "reference": "Patient/c0df2c04a0e64b46ba7fe3f836068e49",
                        "type": "Patient"
                    },
                    "date": "2024-02-22T00:00:00+00:00",
                    "author": [
                        {
                            "reference": "Practitioner/5eede137ecfe4124b8b773040e33be14",
                            "type": "Practitioner"
                        }
                    ],
                    "custodian": {
                        "reference": "Organization/00000000-0000-0000-0002-000000000000",
                        "type": "Organization"
                    },
                    "description": "Handicap Parking Permit",
                    "content": [
                        {
                            "attachment": {
                                "extension": [
                                    {
                                        "url": "http://schemas.canvasmedical.com/fhir/extensions/deprecated-url",
                                        "valueUri": "https://canvas-client-media.s3.amazonaws.com/training/dummy_BLseNPP.pdf?AWSAccessKeyId=AKIAQB7SIDR7EI2V32FZ&Signature=uBuEZpbxcCg4w9hZ6hAXLJxMGe8%3D&Expires=1709072108"
                                    }
                                ],
                                "contentType": "application/pdf",
                                "url": "https://fumage-example.canvasmedical.com/DocumentReference/04a71b54-89b0-49bf-96be-60b5bdfa6450/files/content"
                            },
                            "format": {
                                "system": "http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem",
                                "code": "urn:ihe:iti:xds:2017:mimeTypeSufficient",
                                "display": "mimeType Sufficient"
                            }
                        }
                    ]
                }
            },
            {
                "resource": {
                    "resourceType": "DocumentReference",
                    "id": "efe6c0d6-97c0-42a6-91ba-926a2dc3c66f",
                    "extension": [
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-comment",
                            "valueString": "Disability form comment"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-clinical-date",
                            "valueDate": "2024-01-15"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-review-mode",
                            "valueCode": "RN"
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-reviewer",
                            "valueReference": {
                                "reference": "Practitioner/4150cd20de8a470aa570a852859ac87e",
                                "type": "Practitioner"
                            }
                        },
                        {
                            "url": "http://schemas.canvasmedical.com/fhir/document-reference-priority",
                            "valueBoolean": false
                        }
                    ],
                    "status": "current",
                    "type": {
                        "text": "Disability Form"
                    },
                    "category": [
                        {
                            "coding": [
                                {
                                    "system": "http://schemas.canvasmedical.com/fhir/document-reference-category",
                                    "code": "patientadministrativedocument"
                                }
                            ]
                        }
                    ],
                    "subject": {
                        "reference": "Patient/c0df2c04a0e64b46ba7fe3f836068e49",
                        "type": "Patient"
                    },
                    "date": "2024-02-22T00:00:00+00:00",
                    "author": [
                        {
                            "reference": "Practitioner/5eede137ecfe4124b8b773040e33be14",
                            "type": "Practitioner"
                        }
                    ],
                    "custodian": {
                        "reference": "Organization/00000000-0000-0000-0002-000000000000",
                        "type": "Organization"
                    },
                    "description": "Disability Form",
                    "content": [
                        {
                            "attachment": {
                                "extension": [
                                    {
                                        "url": "http://schemas.canvasmedical.com/fhir/extensions/deprecated-url",
                                        "valueUri": "https://canvas-client-media.s3.amazonaws.com/training/dummy_BLseNPP.pdf?AWSAccessKeyId=AKIAQB7SIDR7EI2V32FZ&Signature=uBuEZpbxcCg4w9hZ6hAXLJxMGe8%3D&Expires=1709072108"
                                    }
                                ],
                                "contentType": "application/pdf",
                                "url": "https://fumage-example.canvasmedical.com/DocumentReference/efe6c0d6-97c0-42a6-91ba-926a2dc3c66f/files/content"
                            },
                            "format": {
                                "system": "http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem",
                                "code": "urn:ihe:iti:xds:2017:mimeTypeSufficient",
                                "display": "mimeType Sufficient"
                            }
                        }
                    ]
                }
            },
            {
                "resource": {
                    "resourceType": "DocumentReference",
                    "id": "380ad499-ec8f-4f1f-b1f0-5f25b04fd574",
                    "status": "current",
                    "type": {
                        "coding": [
                            {
                                "system": "http://loinc.org",
                                "code": "34895-3",
                                "display": "Education note"
                            }
                        ],
                        "text": "Education note"
                    },
                    "category": [
                        {
                            "coding": [
                                {
                                    "system": "http://schemas.canvasmedical.com/fhir/document-reference-category",
                                    "code": "educationalmaterial"
                                }
                            ]
                        }
                    ],
                    "subject": {
                        "reference": "Patient/c0df2c04a0e64b46ba7fe3f836068e49",
                        "type": "Patient"
                    },
                    "date": "2024-02-22T00:00:00+00:00",
                    "author": [
                        {
                            "reference": "Practitioner/4150cd20de8a470aa570a852859ac87e",
                            "type": "Practitioner"
                        }
                    ],
                    "custodian": {
                        "reference": "Organization/00000000-0000-0000-0002-000000000000",
                        "type": "Organization"
                    },
                    "description": "Making a birth plan",
                    "content": [
                        {
                            "attachment": {
                                "extension": [
                                    {
                                        "url": "http://schemas.canvasmedical.com/fhir/extensions/deprecated-url",
                                        "valueUri": "https://canvas-client-media.s3.amazonaws.com/training/generic_documents/Glaucoma_Screening_lFimBWS.pdf?AWSAccessKeyId=AKIAQB7SIDR7EI2V32FZ&Signature=2IfdGPA%2FOMFdRf3p75oYhY6QJ%2Bs%3D&Expires=1709072109"
                                    }
                                ],
                                "contentType": "application/pdf",
                                "url": "https://fumage-example.canvasmedical.com/DocumentReference/380ad499-ec8f-4f1f-b1f0-5f25b04fd574/files/content"
                            },
                            "format": {
                                "system": "http://ihe.net/fhir/ValueSet/IHE.FormatCode.codesystem",
                                "code": "urn:ihe:iti:xds:2017:mimeTypeSufficient",
                                "display": "mimeType Sufficient"
                            }
                        }
                    ],
                    "context": {
                        "encounter": [
                            {
                                "reference": "Encounter/879b35fd-3bc2-4ccd-98d7-954dd9b6d0a9",
                                "type": "Encounter"
                            }
                        ],
                        "period": {
                            "start": "2024-02-22T23:10:12.409838+00:00"
                        }
                    }
                }
            }
        ]
    }
    
  • {
      "resourceType": "OperationOutcome",
      "issue": [
        {
          "severity": "error",
          "code": "invalid",
          "details": {
            "text": "Bad request"
          }
        }
      ]
    }
    
  • {
      "resourceType": "OperationOutcome",
      "issue": [
        {
          "severity": "error",
          "code": "unknown",
          "details": {
            "text": "Authentication failed"
          }
        }
      ]
    }
    
  • {
      "resourceType": "OperationOutcome",
      "issue": [
        {
          "severity": "error",
          "code": "forbidden",
          "details": {
            "text": "Authorization failed"
          }
        }
      ]
    }