DocumentRetrieveRequest
API Information
The DocumentRetrieveRequest is a GET message that will use the following web service API endpoint information to retrieve a document through Surescripts.
| Operation | API Endpoint Description | Description |
|---|---|---|
| Document Retrieve | GET [base]/Binary?documentID= |
Returns the document in binary form. |
Note: As a responder you will be responsible for defining the endpoint information and URL for others to retrieve documents from your system. That information is returned in the DocumentSearchResponse from your system.
Content Types and Encodings
According to Section 3.1.0.1.9 of the FHIR® specification Content Types and encodings,
“The formal MIME-type for FHIR® resources is application/fhir+json or application/fhir+xml. The correct mime type SHALL be used by clients and servers.” Later in that same section, “UTF-8 encoding SHALL be used for the mime type application/fhir. This MAY be specified as a MIME type parameter to the application/fhir mime type, but is not required.”FHIR® uses UTF-8 for all request and response bodies. Since the HTTP specification (section 3.7.1) defines a default character encoding of ISO-8859-1, requests and responses SHALL explicitly set the character encoding to UTF-8 using the charset parameter of the MIME-type in the Content-Type header. Requests MAY also specify this charset parameter in the Accept header and/or use the Accept-Charset header.”
Because of these requirements, requests/responses will need to include a Content-Type in the HTTP header. Below is an example:
- Content-Type: application/fhir+json; charset=utf-8
Note: charset=utf-8 is not required by Surescripts, but is supported if sent.
Additionally, the FHIR® RLE product also supports the use of the “_format” parameter as described in Section 3.1.0.1.11 of the FHIR® specification as a way for document requestors to specify their preference to receive requested documents in a format other than what is included in the HTTP header (for situations where a requesting application can