Tross
Demo dataBook a demo
EZDERM

List patient document folders

List patient document folders and files.

POSThttps://preview.ontross.com/api/integrations/ezderm/list-patient-document-folders
Request Fields
input.patient_id
string
required
Patient UUID returned by the medical record lookup.
Example
"98438b57-d24f-37d3-1bbf-08930d1f097c"
auth_id
string
required
Saved connection to run this operation through, from the Authentication page. It decides which practice and login the call uses.
Example
"00000000-0000-4000-8000-000000000000"
Output Fields
patient_id
string
Patient UUID supplied for the document directory listing.
Example
"98438b57-d24f-37d3-1bbf-08930d1f097c"
folders
array
Document directories traversed breadth-first, excluding the patient's root.
folders[].id
string
Document container identifier accepted by the folder download endpoint.
Example
"744035b4-cbd2-b9ad-ec03-c882ff70ff30"
folders[].name
string
Server-returned label for this individual document container.
Example
"Vul 0 7769 27-44"
folders[].parent_id
string
Containing directory's identifier, or null when unavailable.
Example
"aac45318-6e15-f394-7a8e-328802dd73f0"
folders[].path
string
Slash-separated location relative to the patient's document root.
Example
"Example text."
folders[].files
array
Attachment records, or null when listings are unavailable or incomplete.
folders[].files[].id
string
Attachment UUID accepted by the individual document download endpoint.
Example
"e8c317a4-6f29-4d05-b782-93a60c1f254e"
folders[].files[].name
string
Attachment label returned in the directory details.
Example
"intake-questionnaire.pdf"
folders[].files[].mime_type
string
Server-reported content type, or null when unavailable.
Example
"application/pdf"
folders[].files[].size
integer
Server-reported byte count, or null when unavailable.
Example
48216
folders[].files[].date_modified
string
Server-reported modification timestamp, or null when unavailable.
Example
"2026-10-08T12:30:00.000+00:00"
Code
curl --request POST \
  --url https://preview.ontross.com/api/integrations/ezderm/list-patient-document-folders \
  --header 'X-API-Key: REPLACE_KEY_VALUE' \
  --header 'content-type: application/json' \
  --data '{"input":{"patient_id":"98438b57-d24f-37d3-1bbf-08930d1f097c"},"auth_id":"auth_uuid_here"}'
Request BODY
{
  "input": {
    "patient_id": "98438b57-d24f-37d3-1bbf-08930d1f097c"
  },
  "auth_id": "auth_uuid_here"
}
Response BODY
{
  "id": "string",
  "workflow_id": "string",
  "auth_id": "string",
  "status": "string",
  "input": {},
  "output": {
    "patient_id": "98438b57-d24f-37d3-1bbf-08930d1f097c",
    "folders": [
      {
        "id": "744035b4-cbd2-b9ad-ec03-c882ff70ff30",
        "name": "Vul 0 7769 27-44",
        "parent_id": "2ab64813-f905-4e7c-a2d1-8c3765b90e42",
        "path": "Example text.",
        "files": [
          {
            "id": "e8c317a4-6f29-4d05-b782-93a60c1f254e",
            "name": "intake-questionnaire.pdf",
            "mime_type": "application/pdf",
            "size": 48216,
            "date_modified": "2026-10-08T12:30:00.000+00:00"
          }
        ]
      }
    ]
  },
  "files": null,
  "created_at": "2019-08-24T14:15:22Z",
  "started_at": "2019-08-24T14:15:22Z",
  "completed_at": "2019-08-24T14:15:22Z"
}