Skip to main content

GetClaimReports

Returns the reports attached to a claim, with binary file content included.

Purpose

Returns the reports attached to a claim, with binary file content included. Accepts a claim identifier (claim ID or file number) for a list, or a single FileTracReportID for one report.

Endpoint

  • Method: GetClaimReports

  • SOAPAction (1.1): "https://ftservices.onlinereportinginc.com/v2/GetClaimReports"

  • 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.

FileTracClaimID

int

conditional

System ID of the claim. At least one of FileTracClaimID, FileTracFileNumber, or FileTracReportID must be supplied.

FileTracFileNumber

string

conditional

File # of the claim.

FileTracReportID

int

conditional

System ID of an individual report.

ExcludeConfidential

int

no

0 or 1 (no/yes). When 1, reports flagged confidential are filtered out.

ExcludeDuplicateNameSuffix

int

no

0 or 1 (no/yes). When 1, duplicate report names are not modified with an underscore suffix (e.g., doc_1.pdf).

Response

Returns a list of Report objects (XML element ClaimReportExtract). Each report includes the ReportFile binary content as base64. The nested Media list is included but its elements are returned as xsi:nil="true" placeholders — call GetReportMedia to retrieve media items.

Errors

Error Message

Cause

Remediation

ERROR – No Report found for that reportID

The FileTracReportID does not exist or is not accessible.

Confirm the report ID via GetClaimDetail.

ERROR – No Claim Reports found for the claimID/File# provided

The claim has no reports.

Data state, not an integration error.

ERROR retrieving Reports

Internal error during retrieval.

Retry; if persistent or the claim has very large reports, fetch individually by FileTracReportID.

Remarks

  • At least one lookup parameter is required. If multiple are supplied, the result is the union.

  • Binary file content is returned base64-encoded in the ReportFile element. Decode before writing to disk.

  • Large reports are slow. Reports over 30 MB on the Cloud incur delays. For claims with reports totaling 100 MB or more, call GetClaimReports once per FileTracReportID instead of pulling the full list at once.

  • Duplicate report names get a suffix. FileTrac appends _2, _3, etc., to duplicate file names; higher numbers represent more recent uploads by ReportDate. Use ExcludeDuplicateNameSuffix=1 to retrieve the original names instead.

  • Invalid filename characters are removed. HTML chevrons and other illegal characters are stripped from ReportFileName.

  • Confidential reports may be excluded server-side by setting ExcludeConfidential=1. This is the safest pattern for client-facing integrations.

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/GetClaimReports"<?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>
    <GetClaimReports xmlns="https://ftservices.onlinereportinginc.com/v2/">
      <oParms>
        <Login>integration.svc</Login>
        <Password>•••••••••</Password>
        <CompanyKey>ACME-AC-001</CompanyKey>
        <FileTracReportID>117820</FileTracReportID>
        <ExcludeConfidential>0</ExcludeConfidential>
      </oParms>
    </GetClaimReports>
  </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>
    <GetClaimReportsResponse xmlns="https://ftservices.onlinereportinginc.com/v2/">
      <GetClaimReportsResult>
        <ClaimReportExtract>
          <FileTracClaimID>881204</FileTracClaimID>
          <FileTracFileNumber>AC-26-001142</FileTracFileNumber>
          <FileTracReportID>117820</FileTracReportID>
          <UserID>3327</UserID>
          <UserFName>Linh</UserFName>
          <UserLName>Nguyen</UserLName>
          <ReportDate>2026-05-17T14:20:00</ReportDate>
          <ReportTitle>Initial Inspection Photos</ReportTitle>
          <ReportFileName>inspection_5_17.pdf</ReportFileName>
          <ReportDescription>First-pass photo set, exterior and roof.</ReportDescription>
          <Confidential>0</Confidential>
          <ReportFile>JVBERi0xLjQKJeLjz9MKMyAwIG9iag... (base64 content truncated)</ReportFile>
          <Media>
            <MediaExtract xsi:nil="true" />
          </Media>
        </ClaimReportExtract>
      </GetClaimReportsResult>
    </GetClaimReportsResponse>
  </soap:Body>
</soap:Envelope>

Related Methods

Did this answer your question?