Purpose

Returns the media items (photos and other attachments) associated with a report. Accepts either a ReportID for the full list, or a MediaID for a single item.

Endpoint

Method: GetReportMedia
SOAPAction (1.1): "https://ftservices.onlinereportinginc.com/v2/GetReportMedia"
Parameter wrapper: <oParms>

Authentication

Standard credentials apply. See Authentication & Authorization.

Parameters

Name	Type	Required	Description
`Login`	string	yes	Authorized FileTrac system login.
`Password`	string	yes	Password for the login.
`CompanyKey`	string	yes	The unique company code provided by FileTrac.
`MediaID`	int	conditional	System ID of an individual media item. One of `MediaID` or `ReportID` must be supplied.
`ReportID`	int	conditional	System ID of a report. One of `MediaID` or `ReportID` must be supplied.

Response

Returns a list of MediaExtract objects:

Property	Datatype	Description
`MediaID`	int	System-generated ID unique to this media item.
`MediaDescription`	string	Description of the media item.
`MediaType`	int	Numeric type identifier (e.g., photo, video, document).
`MediaCode`	string	Free-text code or tag.
`MediaFileName`	string	Original file name.
`MediaDate`	dateTime	Date of the media item.
`MediaPath`	string	Internal path / Cloud key for the media file.
`MediaFile`	base64Binary	Binary file content, base64-encoded.

Errors

This method does not produce method-specific business errors. Authentication failures surface via ResponseCode. A missing ReportID or MediaID returns an empty list rather than an error message.

Remarks

One of MediaID or ReportID must be supplied. If both are supplied, the result is the union of media items found by each parameter individually.
Large media items are slow. Items over 30 MB on the Cloud incur retrieval delays. For high-volume photo sets, prefer pulling one item at a time by MediaID.
MediaFile is base64-encoded. Decode before writing to disk.
MediaPath is an internal storage path. Do not attempt to access the underlying storage directly; always retrieve via the API.

Example Request (SOAP 1.1)

POST /v2/service.asmx HTTP/1.1
Host: ftservices.onlinereportinginc.com
Content-Type: text/xml; charset=utf-8
SOAPAction: "https://ftservices.onlinereportinginc.com/v2/GetReportMedia"<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetReportMedia xmlns="https://ftservices.onlinereportinginc.com/v2/">
      <oParms>
        <Login>integration.svc</Login>
        <Password>•••••••••</Password>
        <CompanyKey>ACME-AC-001</CompanyKey>
        <ReportID>117820</ReportID>
      </oParms>
    </GetReportMedia>
  </soap:Body>
</soap:Envelope>

Example Response (SOAP 1.1)

HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
  <soap:Body>
    <GetReportMediaResponse xmlns="https://ftservices.onlinereportinginc.com/v2/">
      <GetReportMediaResult>
        <MediaExtract>
          <MediaID>552901</MediaID>
          <MediaDescription>Front elevation</MediaDescription>
          <MediaType>1</MediaType>
          <MediaCode>EXT-FRONT</MediaCode>
          <MediaFileName>front_01.jpg</MediaFileName>
          <MediaDate>2026-05-17T14:20:30</MediaDate>
          <MediaPath>cloud/ac/001142/117820/front_01.jpg</MediaPath>
          <MediaFile>/9j/4AAQSkZJRgABAQEAYABg... (base64 content truncated)</MediaFile>
        </MediaExtract>
      </GetReportMediaResult>
    </GetReportMediaResponse>
  </soap:Body>
</soap:Envelope>

Related Methods

GetClaimReports — list reports with their binary content. Returns media references but not the media binary.
UploadReport — upload a new report. Media attachments are not uploaded through the API.
Report — the parent type carrying the Media list.