Skip to main content
GET
/
medical
/
v1
/
document
/
download-url
Get Document URL
curl --request GET \
  --url https://api.sandbox.metriport.com/medical/v1/document/download-url \
  --header 'x-api-key: <api-key>'
import { MetriportMedicalApi } from "@metriport/api-sdk";

const metriport = new MetriportMedicalApi("YOUR_API_KEY");

const downloadableUrl = await metriport.getDocumentUrl(
  "abc123-def456"
);

Documentation Index

Fetch the complete documentation index at: https://docs.metriport.com/llms.txt

Use this file to discover all available pages before exploring further.

This endpoint returns a URL which you can use to download the specified document and/or convert using the file name provided from the List Documents endpoint, or from the meta.source field of the FHIR resource you are interested in.
The URL will only be valid for 60 seconds before you need to request a new one.

​
Query Params

​
fileName
string
required
The file name of the document. You can get this from the meta.source attribute of any FHIR resource.
​
conversionType
string
The document type to convert to. Either html or pdf.
This parameter should only be used for converting XML/CDA files.

​
Response

A JSON object containing the URL will be returned.
​
url
string
The downloadable URL.
For patients with a large volume of documents, you can use the Bulk Get Document URL endpoint to get all download URLs instead of doing it one at a time.
import { MetriportMedicalApi } from "@metriport/api-sdk";

const metriport = new MetriportMedicalApi("YOUR_API_KEY");

const downloadableUrl = await metriport.getDocumentUrl(
  "abc123-def456"
);