Purpose

Returns a list of notes for a claim, or a single note by NoteID. Optionally includes the emails attached to each note.

Endpoint

Method: GetClaimNotes
SOAPAction (1.1): "https://ftservices.onlinereportinginc.com/v2/GetClaimNotes"
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 `NoteID` must be supplied.
`NoteID`	int	conditional	System ID of a single note to retrieve.
`FileTracFileNumber`	string	conditional	File # of the claim.
`VisibleToClientOnly`	boolean	no	Default `false`. Set `true` to return only notes flagged visible to the client.
`IncludeNoteEmails`	boolean	no	Default `false`. Set `true` to populate the `Emails` sublist on each returned note. WSDL parameter name uses the plural `Emails` — the Freshdesk narrative documents this as `IncludeNoteEmail` (singular). The WSDL is correct.

Response

Returns a list of Note objects (XML element ClaimNoteExtract). Each note carries an Emails sublist that is empty unless IncludeNoteEmails=true was supplied.

Errors

Error Message	Cause	Remediation
`ERROR – No Note found for that messageID`	The `NoteID` does not exist or is not accessible.	Confirm the `NoteID` via `GetClaimDetail`.
`ERROR – No Notes found for that claimID/File #`	The claim has no notes.	Data state, not an integration error.
`ERROR retrieving Notes`	Internal error during retrieval.	Retry; if persistent, contact FileTrac Support.

Remarks

At least one lookup parameter is required. FileTracClaimID, FileTracFileNumber, or NoteID must be supplied. If multiple are supplied, the result is the union of notes found for each parameter individually.
IncludeNoteEmails materially increases response size. Emails carry full body text. Only request emails when you need them.
VisibleToClientOnly=true filters server-side. Use this when an integration is pulling notes for delivery to a client and must exclude internal-only notes.
Notes are immutable. No update or delete endpoints exist. Treat the result as a read-only event log.

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/GetClaimNotes"<?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>
    <GetClaimNotes xmlns="https://ftservices.onlinereportinginc.com/v2/">
      <oParms>
        <Login>integration.svc</Login>
        <Password>•••••••••</Password>
        <CompanyKey>ACME-AC-001</CompanyKey>
        <FileTracClaimID>881204</FileTracClaimID>
        <IncludeNoteEmails>true</IncludeNoteEmails>
      </oParms>
    </GetClaimNotes>
  </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>
    <GetClaimNotesResponse xmlns="https://ftservices.onlinereportinginc.com/v2/">
      <GetClaimNotesResult>
        <ClaimNoteExtract>
          <FileTracClaimID>881204</FileTracClaimID>
          <FileTracFileNumber>AC-26-001142</FileTracFileNumber>
          <NoteID>552103</NoteID>
          <UserID>3327</UserID>
          <UserFirstName>Linh</UserFirstName>
          <UserLastName>Nguyen</UserLastName>
          <VisibleToClient>Yes</VisibleToClient>
          <NoteTimeStamp>2026-05-15T08:42:11</NoteTimeStamp>
          <Note>Initial contact with insured complete. Inspection scheduled 5/17.</Note>
          <Emails>
            <NoteEmail>
              <From>integration.svc@acme-ia.example</From>
              <To>malvarez@lonestarmutual.example</To>
              <Subject>Claim AC-26-001142 — first contact made</Subject>
              <Body>Confirming initial contact with the insured on 5/15...</Body>
              <Date>2026-05-15T08:45:00</Date>
            </NoteEmail>
          </Emails>
        </ClaimNoteExtract>
      </GetClaimNotesResult>
    </GetClaimNotesResponse>
  </soap:Body>
</soap:Envelope>

Related Methods

AddClaimNote — create a new note.
GetClaimDetail — returns notes inline (without emails).
Note — the type returned.