Skip to main content
GET
/
v0
/
files
/
{id}
Get PDF
curl --request GET \
  --url https://api.getlemma.com/v0/files/{id} \
  --header 'Authorization: Bearer <token>'
{
  "id": "file_Xt7nRv3hBw9pKm4s",
  "url": "https://files.getlemma.com/file_Xt7nRv3hBw9pKm4s?token=eyJhbGciOiJIUzI1NiJ9...",
  "expires_at": "2026-03-15T15:00:00Z"
}
Returns an ephemeral URL you can use to download or render a file. All files are PDFs. The URL expires after 1 hour — request a new one if it has expired. This is useful for viewing the original scanned mail that a check arrived with — for example, to see the EOB or correspondence that accompanied a payment.

​
Path parameters

​
id
string
required
The ID of the file. You can find file IDs in responses from the List entity mail endpoint.

​
Response

Returns a file object with a temporary download URL.
​
id
string
Unique identifier for the file.
​
url
string
A temporary, pre-signed URL to download the PDF. Expires after 1 hour.
​
expires_at
string
ISO 8601 timestamp of when the URL expires.
File URLs are temporary and expire after 1 hour. Do not store them — request a new URL each time you need to access the file.
{
  "id": "file_Xt7nRv3hBw9pKm4s",
  "url": "https://files.getlemma.com/file_Xt7nRv3hBw9pKm4s?token=eyJhbGciOiJIUzI1NiJ9...",
  "expires_at": "2026-03-15T15:00:00Z"
}