Get medical file

Returns the metadata of a single patient file.

Request

GET /api/oauth/v2/resource/files/{uuid}

Header

Header	Value
Authorization	Bearer {access_token}

URL parameters

Parameter	Type	Required	Description
uuid	string	Yes	Unique ID of the file

Response

Success (200 OK)

{
  "data": {
    "id": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "title": "MRI Report",
    "shortTitle": "MRI",
    "date": "2026-06-10",
    "filename": "mri-report.pdf",
    "notice": "Important report, please review.",
    "mimeType": "application/pdf",
    "fileSize": 204800,
    "download": "https://app.offisy.at/api/oauth/v2/resource/files/a1b2c3d4-e5f6-7890-abcd-ef1234567890/download",
    "customer": {
      "id": "f0e1d2c3-b4a5-6789-fedc-ba9876543210",
      "firstName": "Anna",
      "lastName": "Muster"
    }
  }
}

Response fields

Field	Type	Description
data.id	string (UUID)	Unique ID of the file
data.title	string	Title of the file
data.shortTitle	string	Short title of the file
data.date	string | null	Date of the file (YYYY-MM-DD)
data.filename	string	Original filename
data.notice	string | null	Notice/note for the file (stored encrypted server-side)
data.mimeType	string	MIME type of the file (e.g. application/pdf)
data.fileSize	integer	File size in bytes
data.download	string	URL to download the decrypted file
data.customer	object	Assigned customer
data.customer.id	string (UUID)	Customer ID
data.customer.firstName	string	Customer first name
data.customer.lastName	string	Customer last name

Beispiele

bash

curl -X GET "https://my.offisy.at/api/oauth/v2/resource/files/b2c3d4e5-f6a7-8901-bcde-f01234567890" \
  -H "Authorization: Bearer {access_token}"

Server

Client-ID

Client-Secret

Parameter

uuid *string

Zuerst Token anfordern

Possible errors

Status	Code	Description
401	invalid_client	Invalid or missing access token
403	insufficient_scope	Scope medicals not present
403	access_denied	No read permission for this file
404	not_found	File not found or does not belong to this company