Skip to main content

Report

The Report object represents a document attached to a claim. Reports cannot be updated through the API.

The Report object represents a document attached to a claim. Reports are uploaded via UploadReport, listed via GetClaimReports or as part of GetClaimDetail, and cannot be updated through the APIUploadReport is write-only on creation.

The XML element name varies by method:

  • In GetClaimDetail, each report is a ClaimExtractReports element with the minimum metadata.

  • In GetClaimReports, each report is a ClaimReportExtract element with full metadata and the binary file content.

Properties (full set, from GetClaimReports)

Property

Datatype

FileTrac UI Location

Description

FileTracClaimID

int

System ID of the claim this report belongs to.

FileTracFileNumber

string

File # of the claim.

FileTracReportID

int

System-generated ID unique to this report. Pass this to GetClaimReports to retrieve a single report.

UserID

int

System ID of the user who owns the report (typically the adjuster).

UserFName

string

First name of the owner.

UserLName

string

Last name of the owner.

ReportDate

dateTime

Edit Report → Report Date

Date the report was filed. Also on the Report View page.

ReportTitle

string

Edit Report → Report Title

Title as displayed in FileTrac. Also on the Report View page.

ReportFileName

string

Report View → File Name link

Original filename. Invalid characters are removed; duplicate names get a numeric suffix unless ExcludeDuplicateNameSuffix is set.

ReportDescription

string

Description field for the report.

Confidential

int

Edit Report → Confidential

1 for true, 0 for false. When ExcludeConfidential=1 is passed to GetClaimReports, confidential reports are filtered out.

ReportFile

base64Binary

The binary file content, base64-encoded. Returned by GetClaimReports.

Media

List of Media

Attached media items (photos and other attachments). Use GetReportMedia for full retrieval.

In GetClaimDetail, only ReportID, ReportTitle, ReportFileName, ReportDate, and Confidential are returned. The binary file and media list are omitted to keep the claim payload light. Call GetClaimReports with a specific FileTracReportID to retrieve the binary content.

Media (nested)

The Media element holds photos and other attachments to a report. Returned by GetReportMedia. The full media schema is documented in GetReportMedia, which is the only method that returns populated media items.

File-Name Behavior

  • FileTrac allows multiple reports with the same name. Duplicates receive an underscore-suffix (_2, _3, …) where higher numbers represent more recent reports by ReportDate.

  • To prevent the suffix on retrieval, pass ExcludeDuplicateNameSuffix=1 to GetClaimReports.

  • Invalid characters in file names are removed automatically.

Performance

  • Large reports (30 MB and up) on the Cloud can take noticeably longer to retrieve.

  • For claims with reports totaling 100 MB or more, retrieve reports individually by FileTracReportID rather than fetching the full report list at once.

  • The same delay applies to large media items via GetReportMedia.

Constraints

  • Reports cannot be updated through the API. UploadReport only inserts.

  • Reports cannot be deleted through the API.

  • UploadReport does not return media attachments. Media must be uploaded separately through the FileTrac UI or other integration channels.

Related Methods

Did this answer your question?