Skip to main content

GetUsers

Returns active users at the adjusting company, including both internal staff and client-company contacts.

Purpose

Returns active users at the adjusting company, including both internal staff (adjusters, managers, supervisors, claim reps) and client-company contacts. Use it to resolve user IDs for assignment on AddClaim, to enumerate the adjusters available for routing, or to pull adjuster operational data (Xactimate routing, holdback configuration).

Endpoint

  • Method: GetUsers

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

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

ClientCompanyID

int

no

Filter to users belonging to a specific client company.

ClientCompanyName

string

no

Filter by client company name (must match FileTrac exactly).

UserRole

string

no

Filter by role (e.g., Adjuster, ClaimsRep). Must match the role name as it appears in FileTrac.

LastNameSearch

string

no

Left-string prefix match on last name. Ab returns all users whose last name begins with Ab.

Response

Returns a list of User objects (XML element UsersExtract). Each object carries the full user schema including nested Certifications and Licenses lists. When no filter is supplied, all active users at the adjusting company are returned.

Errors

This method does not produce method-specific business errors. Authentication failures surface via ResponseCode. Empty result sets are not errors.

Remarks

  • Active users only. Deactivated users are not returned.

  • Filters compose as a union, not an intersection. Supplying multiple filters returns the union of matching users for each filter individually.

  • LastNameSearch is a prefix match, not a contains-match. Smith matches Smith and Smithson; it does not match Hammersmith.

  • UserRole must match exactly. Role names are defined per adjusting company.

  • Adjuster-specific fields (XactAddress, XactimateKeyCode, HoldbackDays, etc.) are populated only for users in adjuster roles. Client-contact rows leave those fields empty.

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/GetUsers"<?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>
    <GetUsers xmlns="https://ftservices.onlinereportinginc.com/v2/">
      <oParms>
        <Login>integration.svc</Login>
        <Password>•••••••••</Password>
        <CompanyKey>ACME-AC-001</CompanyKey>
        <UserRole>Adjuster</UserRole>
        <LastNameSearch>Ng</LastNameSearch>
      </oParms>
    </GetUsers>
  </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>
    <GetUsersResponse xmlns="https://ftservices.onlinereportinginc.com/v2/">
      <GetUsersResult>
        <UsersExtract>
          <UserID>3327</UserID>
          <UserCode>LNG-01</UserCode>
          <UserTitle>Senior Adjuster</UserTitle>
          <UserFName>Linh</UserFName>
          <UserLName>Nguyen</UserLName>
          <UserAddr1>4801 Spring Valley Road</UserAddr1>
          <UserCity>Dallas</UserCity>
          <UserState>TX</UserState>
          <UserZIP>75244</UserZIP>
          <UserCountry>USA</UserCountry>
          <UserPhone1>214-555-0188</UserPhone1>
          <UserEmail>lnguyen@example-ia.com</UserEmail>
          <XactAddress>lnguyen-xact@example-ia.com</XactAddress>
          <XactimateVersion>X1</XactimateVersion>
          <UserAPR>4.8</UserAPR>
          <UserTouchPoints>5</UserTouchPoints>
          <HoldbackDays>30</HoldbackDays>
          <HoldbackPercent>10</HoldbackPercent>
          <UserEORate>0.005</UserEORate>
          <BranchName>Dallas Main</BranchName>
          <ClientCompanyID>0</ClientCompanyID>
          <FileTracUniqueID>884201</FileTracUniqueID>
          <Certifications/>
          <Licenses/>
        </UsersExtract>
      </GetUsersResult>
    </GetUsersResponse>
  </soap:Body>
</soap:Envelope>

Related Methods

  • GetClientContacts — leaner schema scoped to a single client company.

  • AddClaim — uses user IDs to assign adjuster, manager, supervisor, and client contact.

  • User — the full type returned in each UsersExtract.

Did this answer your question?