Liberty Mutual Mobile icon

Liberty Mutual Mobile Data API: Endpoints & Fields

Liberty Mutual Insurance Company · Banking

Liberty Mutual Mobile is the Android client of Liberty Mutual Insurance Company for US auto, home and renters policyholders. It lists every policy on the account with downloadable auto ID cards, files and tracks claims from first notice through appraisal, repair appointments and rental reservations, shows amount due and payment history for each billing account, mails or faxes policy documents, opens roadside assistance, keeps the assigned agent's contact details at hand, and hosts RightTrack, Liberty Mutual's usage-based telematics program that records trips and scores driving. Policyholders use it as the proof-of-insurance wallet in the car, the claims tracker after a collision, and the billing portal for monthly premium payments, placing it in the US personal-lines market alongside GEICO, State Farm, Progressive and Allstate.

Claim records returned for a signed-in policyholder carry claimNumber, lossDate, lossCause, lossCategory and a workflow status, with nested appointments, autoAppraisals, rental and adjusterContactInfo blocks that say where the repair, appraisal and rental actually stand. Policy records pair policyNumber and policyLineOfBusiness with effectiveDate and expirationDate and an idCards array holding the insured vehicle's idNumber, make, model, year and namedInsureds, while annualPremium, driverSummaryList and lenders fill out the coverage detail view.

Billing accounts add amountDue, remainingAccountBalance, isAutoPay, latestPayment and a currentPaymentMethod containing a maskedAccountNumber, and the RightTrack side contributes totalDistance, confirmedTripCount, coaching flags and a per-operator performanceScore. With policyholder authorization, insurance agencies and claims-tech teams can use these records for premium reconciliation and claims-cycle dashboards, family-finance apps can assemble proof-of-insurance wallets with expiry reminders, and mobility-data teams can analyze driving scores alongside confirmed mileage. openData Studio turns these policy, claims, billing and telematics records into callable open data.

Screenshots

  • Liberty Mutual Mobile screenshot 1
  • Liberty Mutual Mobile screenshot 2

API surface

The endpoints and request/response examples below are reconstructed from the app's interface — illustrative, not a live capture.

  • Policy list with auto ID cards

    POST /illustrative/v1/policy-service/policy-overview openfinance

    Loads the policy dashboard: every policy on the account with its status, jurisdiction, term dates, vehicle-level ID cards (VIN, make, model, year, named insureds) and renewal and document links. Feeds the policy list, the ID-card wallet and the renewal reminder badge.

    Auth: Auth0 OIDC access token for the signed-in policyholder, sent as Authorization: Bearer; issued through the app's Auth0 login with PKCE and the registered app redirect.

    • policiesSummary
    • hasVehicularPolicy
    • idCardCount
    • renewalCount
    • policyNumber
    • policyType
    • policyStatus
    • policyJurisdiction
    • policyLineOfBusiness
    • effectiveDate
    • expirationDate
    • idCards
    • cardType
    • insuredVehicle
    • idNumber
    • idType
    • make
    • model
    • year
    • namedInsureds
    • fullName
    • renewal
    POST /illustrative/v1/policy-service/policy-overview HTTP/1.1
    Authorization: Bearer <ACCESS_TOKEN>
    Content-Type: application/json
    
    {
      "operationName": "ExamplePoliciesSummary",
      "query": "query ExamplePoliciesSummary { policiesSummary { hasVehicularPolicy idCardCount renewalCount policies { policyNumber policyType policyStatus policyJurisdiction policyLineOfBusiness effectiveDate expirationDate idCards { cardType policyNumber insuredVehicle { idNumber idType make model year } namedInsureds { fullName } } renewal { isComplete } } } }"
    }
    {
      "data": {
        "policiesSummary": {
          "hasVehicularPolicy": true,
          "idCardCount": 2,
          "renewalCount": 1,
          "policies": [
            {
              "policyNumber": "AOS-1234567-01",
              "policyType": "AUTO",
              "policyStatus": "Active",
              "policyJurisdiction": "CA",
              "policyLineOfBusiness": "Personal Auto",
              "effectiveDate": "2026-03-01",
              "expirationDate": "2027-03-01",
              "idCards": [
                {
                  "cardType": "Auto",
                  "insuredVehicle": {
                    "idNumber": "1HGCV1F34LA123456",
                    "idType": "VIN",
                    "make": "HONDA",
                    "model": "ACCORD",
                    "year": "2021"
                  },
                  "namedInsureds": [
                    {
                      "fullName": "JORDAN A SAMPLE"
                    }
                  ]
                }
              ],
              "renewal": {
                "isComplete": false
              }
            }
          ]
        }
      }
    }
  • Policy detail with drivers and vehicles

    POST /illustrative/v1/policy-service/policy-record openfinance

    Returns one policy's full record: term, annual premium, named insureds, mailing address, rated drivers and vehicles on auto policies, and mortgage lenders on property policies. Backs the policy detail tabs and coverage overview.

    Auth: Auth0 OIDC Bearer access token; the policy must belong to the signed-in household.

    • policyDetails
    • policyType
    • policyStatus
    • number
    • effectiveDate
    • expirationDate
    • annualPremium
    • namedInsureds
    • address
    • drivers
    • vehicles
    • driverSummaryList
    • firstName
    • lastName
    • isNamedInsured
    • isAdditional
    • isRestricted
    • lenders
    POST /illustrative/v1/policy-service/policy-record HTTP/1.1
    Authorization: Bearer <ACCESS_TOKEN>
    Content-Type: application/json
    
    {
      "operationName": "ExamplePolicyDetails",
      "variables": {
        "policyNumber": "AOS-1234567-01"
      },
      "query": "query ExamplePolicyDetails($policyNumber: String!) { policyDetails(policyNumber: $policyNumber) { policyType policyStatus description number effectiveDate expirationDate annualPremium namedInsureds address { addressLine1 city state zipCode } ... on AutoPolicy { drivers vehicles driverSummaryList { firstName lastName isNamedInsured isAdditional isRestricted } } ... on PropertyPolicy { lenders } } }"
    }
    {
      "data": {
        "policyDetails": {
          "__typename": "AutoPolicy",
          "policyType": "AUTO",
          "policyStatus": "Active",
          "number": "AOS-1234567-01",
          "effectiveDate": "2026-03-01",
          "expirationDate": "2027-03-01",
          "annualPremium": 1842.5,
          "namedInsureds": [
            "JORDAN A SAMPLE"
          ],
          "driverSummaryList": [
            {
              "firstName": "JORDAN",
              "lastName": "SAMPLE",
              "isNamedInsured": true,
              "isAdditional": false,
              "isRestricted": false
            }
          ],
          "vehicles": [
            {
              "year": "2021",
              "make": "HONDA",
              "model": "ACCORD"
            }
          ]
        }
      }
    }
  • Claims list and repair tracking

    POST /illustrative/v1/policy-service/claim-progress openfinance

    Lists every open and closed claim with loss date, cause, status, body-shop and appraisal appointments, rental eligibility and reservation, and the assigned adjuster's phone and email. Drives the claims tab and the claim-detail timeline.

    Auth: Auth0 OIDC Bearer access token; claims are scoped to the signed-in policyholder.

    • getClaims
    • results
    • claimNumber
    • reportedDate
    • lossDate
    • lossCause
    • lossCategory
    • status
    • policyType
    • policyLineOfBusiness
    • targetUrl
    • schedulingUrl
    • documentsUrl
    • paymentsUrl
    • appointments
    • adjusterName
    • startTime
    • endTime
    • workType
    • arrivalWindowStartTime
    • contractorRepairNetworkStatus
    • autoAppraisals
    • appraisalType
    • channel
    • rental
    • isEligible
    • hasCoverage
    • dailyRate
    • reservationNumber
    • rentalCompany
    • insuredVehicle
    • isEstimateAvailable
    • genpactContentsId
    • adjusterContactInfo
    POST /illustrative/v1/policy-service/claim-progress HTTP/1.1
    Authorization: Bearer <ACCESS_TOKEN>
    Content-Type: application/json
    
    {
      "operationName": "ExampleClaims",
      "variables": {
        "plnarEnabled": true,
        "hoverEnabled": true
      },
      "query": "query ExampleClaims($plnarEnabled: Boolean!, $hoverEnabled: Boolean!) { getClaims { results { claimNumber reportedDate lossDate lossCause lossCategory status policyType policyLineOfBusiness appointments { id adjusterName startTime endTime workType status } rental { isEligible hasCoverage dailyRate reservation { reservationNumber rentalCompany status } } autoAppraisals { id appraisalType channel } insuredVehicle { year make model } adjusterContactInfo { name phoneNumber email } } } }"
    }
    {
      "data": {
        "getClaims": {
          "results": [
            {
              "claimNumber": "CA-0042-123456",
              "reportedDate": "2026-08-14",
              "lossDate": "2026-08-12",
              "lossCause": "Collision",
              "lossCategory": "Auto",
              "status": "In Repair",
              "policyType": "AUTO",
              "policyLineOfBusiness": "Personal Auto",
              "appointments": [
                {
                  "id": "APPT-77",
                  "adjusterName": "R. CALDWELL",
                  "startTime": "2026-08-20T15:00:00Z",
                  "endTime": "2026-08-20T17:00:00Z",
                  "workType": "Appraisal",
                  "status": "Scheduled"
                }
              ],
              "rental": {
                "isEligible": true,
                "hasCoverage": true,
                "dailyRate": 45.0,
                "reservation": {
                  "reservationNumber": "ENT-88213",
                  "rentalCompany": "Enterprise",
                  "status": "Confirmed"
                }
              },
              "insuredVehicle": {
                "year": "2021",
                "make": "HONDA",
                "model": "ACCORD"
              },
              "adjusterContactInfo": {
                "name": "R. CALDWELL",
                "phoneNumber": "+18005550142",
                "email": "[email protected]"
              }
            }
          ]
        }
      }
    }
  • Billing account and payment summary

    POST /illustrative/v1/policy-service/billing-overview openbanking

    Reads each billing account's amount due, due date, auto-pay flag, last payment and masked payment method, plus the policies paid from that account. Powers the billing tab, the payment CTA and the renewal banner.

    Auth: Auth0 OIDC Bearer access token; billing accounts are resolved from the policyholder's household.

    • billingDetailsV1
    • billingAccounts
    • id
    • accountNumber
    • type
    • amountDue
    • float
    • amountInCents
    • formattedStr
    • upcomingPaymentDueDateV2
    • renewalDate
    • isAutoPay
    • isPastDue
    • isBillReady
    • latestPayment
    • paymentDate
    • remainingAccountBalance
    • billingFrequencyInfo
    • currentPaymentMethod
    • methodType
    • maskedAccountNumber
    • policies
    • policyNumber
    • policyStatus
    • LOB
    POST /illustrative/v1/policy-service/billing-overview HTTP/1.1
    Authorization: Bearer <ACCESS_TOKEN>
    Content-Type: application/json
    
    {
      "operationName": "ExampleBillingDetailsV1",
      "variables": {
        "useCache": false
      },
      "query": "query ExampleBillingDetailsV1($useCache: Boolean) { billingDetailsV1(useCache: $useCache) { billingAccounts { id accountNumber type amountDue { float amountInCents formattedStr } upcomingPaymentDueDateV2 renewalDate isAutoPay isPastDue areYouPaidInFull currentPaymentMethod { methodType option { ... on Eft { category maskedAccountNumber } } } latestPayment { amount { float } paymentDate } policies { policyNumber policyType policyStatus LOB } } } }"
    }
    {
      "data": {
        "billingDetailsV1": {
          "billingAccounts": [
            {
              "id": "BA-90011223",
              "accountNumber": "0001234567",
              "type": "Auto + Home",
              "amountDue": {
                "float": 214.37,
                "amountInCents": 21437,
                "formattedStr": "$214.37"
              },
              "upcomingPaymentDueDateV2": "2026-11-01",
              "renewalDate": "2027-03-01",
              "isAutoPay": true,
              "isPastDue": false,
              "currentPaymentMethod": {
                "methodType": "EFT",
                "option": {
                  "category": "Checking",
                  "maskedAccountNumber": "****6789"
                }
              },
              "latestPayment": {
                "amount": {
                  "float": 214.37
                },
                "paymentDate": "2026-10-01"
              },
              "policies": [
                {
                  "policyNumber": "AOS-1234567-01",
                  "policyType": "AUTO",
                  "policyStatus": "Active",
                  "LOB": "Personal Auto"
                }
              ]
            }
          ]
        }
      }
    }
  • Signed-in user profile

    POST /illustrative/v1/policy-service/policyholder-profile openfinance

    Resolves the signed-in customer's contact details, identity reference and paperless-enrollment state, which the account screen and paperless prompts render.

    Auth: Auth0 OIDC Bearer access token; returns the profile attached to the token.

    • userprofile
    • emailAddress
    • firstName
    • lastName
    • phone
    • showPaperlessModal
    • paperlessPreferences
    • userIdentity
    • requirePaperlessReenrollment
    POST /illustrative/v1/policy-service/policyholder-profile HTTP/1.1
    Authorization: Bearer <ACCESS_TOKEN>
    Content-Type: application/json
    
    {
      "operationName": "ExampleUserProfile",
      "query": "query ExampleUserProfile { userprofile { emailAddress firstName lastName phone showPaperlessModal paperlessPreferences userIdentity requirePaperlessReenrollment } }"
    }
    {
      "data": {
        "userprofile": {
          "emailAddress": "[email protected]",
          "firstName": "JORDAN",
          "lastName": "SAMPLE",
          "phone": "+15550123456",
          "showPaperlessModal": false,
          "paperlessPreferences": "ENROLLED",
          "userIdentity": "LMPORTAL-88213",
          "requirePaperlessReenrollment": false
        }
      }
    }
  • Agent contact record

    POST /illustrative/v1/policy-service/servicing-agent openfinance

    Returns the assigned agent or agency with phone, email and SMS availability windows so the contact card can route policy changes and claims questions.

    Auth: Auth0 OIDC Bearer access token; the agent is assigned to the policyholder.

    • agent
    • agencyName
    • phoneNumber
    • emailAddress
    • isGold
    • smsAvailability
    • from
    • to
    • timeZone
    POST /illustrative/v1/policy-service/servicing-agent HTTP/1.1
    Authorization: Bearer <ACCESS_TOKEN>
    Content-Type: application/json
    
    {
      "operationName": "ExampleAgent",
      "query": "query ExampleAgent { agent { agencyName phoneNumber emailAddress isGold smsAvailability { from to timeZone } } }"
    }
    {
      "data": {
        "agent": {
          "agencyName": "Sample Insurance Agency",
          "phoneNumber": "+18005550199",
          "emailAddress": "[email protected]",
          "isGold": true,
          "smsAvailability": {
            "from": "09:00",
            "to": "18:00",
            "timeZone": "America/Los_Angeles"
          }
        }
      }
    }
  • Account resource summaries

    POST /illustrative/v1/policy-service/dashboard-summaries openfinance

    Aggregates the home-dashboard cards: a billing summary, e-sign session count, policy-mismatch notice and cross-sell/up-sell offers, each with its own body copy and CTA metadata.

    Auth: Auth0 OIDC Bearer access token.

    • resourceSummary
    • liveContentSummary
    • eSignSummary
    • sessionCount
    • shouldDisplayDocusignCard
    • billingSummary
    • paymentDueAmount
    • paymentStatus
    • billingMethodCode
    • policyNumber
    • policyEffectiveDate
    • amount
    • paymentDate
    • policyMismatchSummary
    • crossSellSummary
    • disclaimerTexts
    • textTokens
    • upSellSummary
    • upSellType
    POST /illustrative/v1/policy-service/dashboard-summaries HTTP/1.1
    Authorization: Bearer <ACCESS_TOKEN>
    Content-Type: application/json
    
    {
      "operationName": "ExampleResourceSummary",
      "query": "query ExampleResourceSummary { resourceSummary { liveContentSummary { bodyText } eSignSummary { sessionCount shouldDisplayDocusignCard } billingSummary { paymentDueAmount paymentStatus billingMethodCode policyNumber policyEffectiveDate amount paymentDate } policyMismatchSummary { policyType bodyText } crossSellSummary { disclaimerTexts policyType textTokens { text font } } upSellSummary { upSellType } } }"
    }
    {
      "data": {
        "resourceSummary": {
          "eSignSummary": {
            "sessionCount": 1,
            "shouldDisplayDocusignCard": true
          },
          "billingSummary": {
            "paymentDueAmount": 214.37,
            "paymentStatus": "DUE",
            "billingMethodCode": "EFT",
            "policyNumber": "AOS-1234567-01",
            "policyEffectiveDate": "2026-03-01",
            "amount": 214.37,
            "paymentDate": "2026-11-01"
          },
          "crossSellSummary": {
            "policyType": "HOME",
            "disclaimerTexts": [
              "Bundle and save"
            ],
            "textTokens": [
              {
                "text": "Add home coverage",
                "font": "bold"
              }
            ]
          },
          "upSellSummary": {
            "upSellType": "ACCIDENT"
          }
        }
      }
    }
  • Policy document download URL

    POST /illustrative/v1/policy-service/document-link openfinance

    Exchanges a policy document id for a short-lived download URL, which the documents tab and ID-card PDF viewer open.

    Auth: Auth0 OIDC Bearer access token; document access is limited to documents on the policyholder's policies.

    • getDocumentUrl
    • downloadUrl
    POST /illustrative/v1/policy-service/document-link HTTP/1.1
    Authorization: Bearer <ACCESS_TOKEN>
    Content-Type: application/json
    
    {
      "operationName": "ExampleGetDocumentUrl",
      "variables": {
        "documentId": "9f2c41ab-77de-4c11-9e08-2a5b3e7c1d44",
        "tenant": "lm"
      },
      "query": "query ExampleGetDocumentUrl($documentId: String, $tenant: String) { getDocumentUrl(documentId: $documentId, tenant: $tenant) { downloadUrl } }"
    }
    {
      "data": {
        "getDocumentUrl": {
          "downloadUrl": "<DOCUMENT_DOWNLOAD_URL>"
        }
      }
    }
  • Email policy documents

    POST /illustrative/v1/policy-service/document-delivery openfinance

    Sends an ID card or policy document to a chosen email address from the document screen, returning a success indicator.

    Auth: Auth0 OIDC Bearer access token.

    • sendDocumentsByEmail
    • sendDocumentsRequest
    • successIndicator
    POST /illustrative/v1/policy-service/document-delivery HTTP/1.1
    Authorization: Bearer <ACCESS_TOKEN>
    Content-Type: application/json
    
    {
      "operationName": "ExampleSendDocumentsByEmail",
      "variables": {
        "sendDocumentsRequest": {
          "policyNumber": "AOS-1234567-01",
          "documentType": "ID_CARD",
          "emailAddress": "[email protected]"
        }
      },
      "query": "query ExampleSendDocumentsByEmail($sendDocumentsRequest: SendDocumentsRequestType!) { sendDocumentsByEmail(sendDocumentsRequest: $sendDocumentsRequest) { successIndicator } }"
    }
    {
      "data": {
        "sendDocumentsByEmail": {
          "successIndicator": true
        }
      }
    }
  • Adjuster follow-up message

    POST /illustrative/v1/policy-service/adjuster-messages openfinance

    Posts a follow-up message from the claim-detail screen to the assigned adjuster, carrying the claim number, subject, body and caller contact details.

    Auth: Auth0 OIDC Bearer access token; the claim must belong to the signed-in policyholder.

    • createAdjusterFollowupMessage
    • claimNumber
    • message
    • subject
    • customerName
    • customerPhone
    • isSuccessful
    POST /illustrative/v1/policy-service/adjuster-messages HTTP/1.1
    Authorization: Bearer <ACCESS_TOKEN>
    Content-Type: application/json
    
    {
      "operationName": "ExampleCreateAdjusterFollowupMessage",
      "variables": {
        "claimNumber": "CA-0042-123456",
        "message": "Can we move the appraisal to Friday?",
        "subject": "Appraisal reschedule",
        "customerName": "Jordan Sample",
        "customerPhone": "+15550123456"
      },
      "query": "query ExampleCreateAdjusterFollowupMessage($claimNumber: String!, $message: String!, $subject: String!, $customerName: String!, $customerPhone: String!) { createAdjusterFollowupMessage(claimNumber: $claimNumber, message: $message, subject: $subject, customerName: $customerName, customerPhone: $customerPhone) { isSuccessful } }"
    }
    {
      "data": {
        "createAdjusterFollowupMessage": {
          "isSuccessful": true
        }
      }
    }
  • Push notification registration

    POST /illustrative/v1/policy-service/device-enrollment openfinance

    Registers the handset and FCM token against the policyholder so claim-status, billing and telematics notifications reach the device.

    Auth: Auth0 OIDC Bearer access token, plus the Firebase Cloud Messaging device token.

    • registerPush
    • deviceId
    • pushToken
    • operatorId
    • emailAddress
    • isSuccessful
    POST /illustrative/v1/policy-service/device-enrollment HTTP/1.1
    Authorization: Bearer <ACCESS_TOKEN>
    Content-Type: application/json
    
    {
      "operationName": "ExampleRegisterPush",
      "variables": {
        "deviceId": "a1b2c3d4e5f6",
        "pushToken": "<PUSH_TOKEN>",
        "operatorId": "OP-88213",
        "emailAddress": "[email protected]"
      },
      "query": "query ExampleRegisterPush($deviceId: String!, $pushToken: String!, $operatorId: String, $emailAddress: String) { registerPush(deviceId: $deviceId, pushToken: $pushToken, operatorId: $operatorId, emailAddress: $emailAddress) { isSuccessful } }"
    }
    {
      "data": {
        "registerPush": {
          "isSuccessful": true
        }
      }
    }
  • Paperless preference update

    POST /illustrative/v1/policy-service/paperless-consent openfinance

    Records the policyholder's e-consent decision, signature name and date so policy documents stop arriving by mail and become available in the app.

    Auth: Auth0 OIDC Bearer access token.

    • updatePaperlessPreference
    • modalResponse
    • paperlessPreferences
    • firstName
    • lastName
    • emailAddress
    • signDate
    • successIndicator
    POST /illustrative/v1/policy-service/paperless-consent HTTP/1.1
    Authorization: Bearer <ACCESS_TOKEN>
    Content-Type: application/json
    
    {
      "operationName": "ExampleUpdatePaperlessPreference",
      "variables": {
        "modalResponse": "ACCEPTED",
        "paperlessPreferences": "ENROLLED",
        "firstName": "JORDAN",
        "emailAddress": "[email protected]",
        "lastName": "SAMPLE",
        "signDate": "2026-10-25"
      },
      "query": "query ExampleUpdatePaperlessPreference($modalResponse: PaperlessModalPreference!, $paperlessPreferences: String!, $firstName: String, $emailAddress: String, $lastName: String, $signDate: String) { updatePaperlessPreference(modalResponse: $modalResponse, paperlessPreferences: $paperlessPreferences, firstName: $firstName, emailAddress: $emailAddress, lastName: $lastName, signDate: $signDate) { successIndicator } }"
    }
    {
      "data": {
        "updatePaperlessPreference": {
          "successIndicator": true
        }
      }
    }
  • Product recommendations

    POST /illustrative/v1/policy-service/coverage-offers openfinance

    Returns the next-best product offers for the household, tagged by recommendation type, applicable policy and distribution channel, which the dashboard cross-sell cards render.

    Auth: Auth0 OIDC Bearer access token; recommendations are matched to the household.

    • getRecommendations
    • id
    • type
    • recommend
    • applicableEntity
    • applicableEntityId
    • householdId
    • alignmentIndicator
    • distributionChannel
    POST /illustrative/v1/policy-service/coverage-offers HTTP/1.1
    Authorization: Bearer <ACCESS_TOKEN>
    Content-Type: application/json
    
    {
      "operationName": "ExampleRecommendations",
      "query": "query ExampleRecommendations { getRecommendations { id type recommend applicableEntity applicableEntityId householdId alignmentIndicator distributionChannel } }"
    }
    {
      "data": {
        "getRecommendations": [
          {
            "id": "REC-4471",
            "type": "CROSS_SELL",
            "recommend": "HOME",
            "applicableEntity": "POLICY",
            "applicableEntityId": "AOS-1234567-01",
            "householdId": "HH-22109",
            "alignmentIndicator": "BUNDLE",
            "distributionChannel": "DIRECT"
          }
        ]
      }
    }
  • RightTrack telematics account and trips

    POST /illustrative/v1/policy-service/driving-program openfinance

    Loads the RightTrack usage-based-insurance dashboard: enrolled programs and operators, trip counts and distance, coaching flags and performance score, registration deadline, participation discount and program settings.

    Auth: RightTrack telematics session token and cmtAuthToken from the RightTrack sign-in flow; telematics access tokens are issued by the account's OAuth token exchange.

    • appData
    • appAccount
    • accountId
    • policyNumber
    • clientCode
    • jurisdiction
    • programs
    • clientProgramCode
    • enrollmentDate
    • status
    • operators
    • operatorId
    • firstName
    • lastName
    • trips
    • totalDistance
    • confirmedTripCount
    • unconfirmedTripCount
    • drivingBehavior
    • accelerationCoaching
    • brakingCoaching
    • distractedDrivingCoaching
    • timeOfDayCoaching
    • ranking
    • performanceScore
    • score
    • category
    • daysRemaining
    • registerByDate
    • heartbeat
    • participationDiscount
    • currentDiscount
    • maxDiscount
    • appExperience
    • rightTrackExperienceEnabled
    • minimumMileageThreshold
    • programLength
    • scoringWindow
    POST /illustrative/v1/policy-service/driving-program HTTP/1.1
    Authorization: Bearer <ACCESS_TOKEN>
    Content-Type: application/json
    
    {
      "operationName": "ExampleTelematicsAppData",
      "query": "query ExampleTelematicsAppData { appData { appAccount { accountId policyNumber clientCode jurisdiction programs { clientProgramCode status enrollmentDate operators { operatorId firstName lastName trips { totalDistance confirmedTripCount unconfirmedTripCount } drivingBehavior { brakingCoaching distractedDrivingCoaching ranking performanceScore { score category } } } } } appExperience { rightTrackExperienceEnabled minimumMileageThreshold programLength scoringWindow } } }"
    }
    {
      "data": {
        "appData": {
          "appAccount": {
            "accountId": "ACCT-77120",
            "policyNumber": "AOS-1234567-01",
            "clientCode": "LM",
            "jurisdiction": "CA",
            "programs": [
              {
                "clientProgramCode": "RIGHTTRACK",
                "status": "ACTIVE",
                "enrollmentDate": "2026-03-05",
                "operators": [
                  {
                    "operatorId": "OP-88213",
                    "firstName": "JORDAN",
                    "lastName": "SAMPLE",
                    "trips": {
                      "totalDistance": 421.6,
                      "confirmedTripCount": 38,
                      "unconfirmedTripCount": 2
                    },
                    "drivingBehavior": {
                      "brakingCoaching": "LOW",
                      "distractedDrivingCoaching": "MEDIUM",
                      "ranking": 12,
                      "performanceScore": {
                        "score": 82,
                        "category": "GOOD"
                      }
                    }
                  }
                ]
              }
            ]
          },
          "appExperience": {
            "rightTrackExperienceEnabled": true,
            "minimumMileageThreshold": 50,
            "programLength": "6_MONTHS",
            "scoringWindow": "90_DAYS"
          }
        }
      }
    }
  • Confirm telematics trips

    POST /illustrative/v1/policy-service/trip-confirmations openfinance

    Confirms or rejects detected trips for each operator, which feeds confirmed mileage into the RightTrack score and discount calculation.

    Auth: RightTrack session token (Bearer) obtained from the RightTrack sign-in flow.

    • confirmTrips
    • tripConfirmation
    • operatorId
    • tripId
    • isDriver
    POST /illustrative/v1/policy-service/trip-confirmations HTTP/1.1
    Authorization: Bearer <ACCESS_TOKEN>
    Content-Type: application/json
    
    {
      "operationName": "ExampleLibertyConfirmTrip",
      "variables": {
        "tripConfirmation": [
          {
            "operatorId": "OP-88213",
            "tripId": "TRIP-20261024-0912",
            "isDriver": true
          }
        ]
      },
      "query": "mutation ExampleLibertyConfirmTrip($tripConfirmation: [TripConfirmationInput!]!) { confirmTrips(tripConfirmations: $tripConfirmation) }"
    }
    {
      "data": {
        "confirmTrips": true
      }
    }

Data categories

  • insurance policies
  • auto ID cards
  • claims
  • claim appointments and appraisals
  • rental reservations
  • billing and payments
  • policy documents
  • drivers and vehicles
  • agent contacts
  • telematics driving data

Where teams use this data

  • Claims-cycle dashboard

    A claims-operations tool joins claimNumber, lossDate, lossCause and status from the claims feed with adjusterContactInfo and the appointment arrivalWindowStartTime to watch cycle time from first notice of loss to appraisal and repair hand-off.

  • Proof-of-insurance wallet

    A fleet or family finance app pulls policyNumber, policyLineOfBusiness and the idCards array (insuredVehicle idNumber, make, model, year and namedInsureds) to render current ID cards and warn before expirationDate.

  • Premium and billing reconciliation

    An agency bookkeeping job matches billingAccounts' amountDue, remainingAccountBalance, isAutoPay and latestPayment against policyNumber and annualPremium from policyDetails, flagging past-due households and failed auto-pay.

  • Usage-based insurance analytics

    A mobility-data team reads totalDistance, confirmedTripCount, brakingCoaching and performanceScore per operator to benchmark RightTrack driving behaviour and model renewal discount bands.

Frequently asked questions

What insurance data does the Liberty Mutual app expose?

The data includes policies with term dates, jurisdictions and vehicle-level ID cards; claims with loss cause, status, appointments, appraisals and rental reservations; billing accounts with amountDue, isAutoPay, isPastDue and latestPayment; policy document download links; the assigned agent's contact record; and RightTrack programs with trip counts, distance and driving scores. The billing model shown here includes the latest payment, not a complete payment-history ledger.

Are these endpoints public?

No. The first-party calls require a signed-in policyholder. Consumer data uses a GraphQL gateway with an Auth0 OIDC access token obtained through the app's PKCE login; telematics data requires the RightTrack session token issued for an enrolled policy. The paths and examples on this page are illustrative, not production access points.

How can policy and billing records be reconciled?

Match the number in policyDetails to policyNumber in each billing account's policies list. Policy details supply annualPremium and term dates, while billing accounts supply amountDue, remainingAccountBalance, isAutoPay, isPastDue and latestPayment. A billing account can cover more than one policy, so its amount due should not be treated as the annual premium for a single policy. isPastDue marks an overdue balance; isAutoPay alone does not establish whether a payment succeeded.

How is RightTrack driving data structured?

Each telematics program lists operators with a trips object (totalDistance, confirmedTripCount, unconfirmedTripCount) and a drivingBehavior object with coaching flags, ranking and a performanceScore carrying a numeric score and category, plus participation-discount figures.

Apps similar to Liberty Mutual Mobile

  • GEICO Mobile - Car Insurance — GEICO (Government Employees Insurance Company) is a Bethesda, Maryland auto insurer wholly owned by Berkshire Hathaway that writes private passenger automobile insurance in all 50 U.S. states and the District of Columbia.
  • Progressive — The Progressive Corporation, based in Mayfield, Ohio, sells auto, motorcycle, RV and related vehicle insurance plus home and renters cover through selected insurers, offers a voluntary Snapshot usage-based program, and lets customers buy coverage by phone, online or through independent agents.
  • State Farm — The State Farm app from State Farm® gives customers insurance policy management, roadside assistance, claim filing, bank and investment account information, and access to Drive Safe & Save details.
  • Allstate — The Allstate Corporation, headquartered in Glenview, Illinois, is a U.S. insurer that writes coverage for cars, homes, renters, motorcycles, boats, condos, landlords and businesses, and also operates personal-lines insurance in Canada.
  • USAA — United Services Automobile Association (USAA), headquartered in San Antonio, Texas, provides insurance and banking to U.S. service members, veterans and their families.
  • Farmers Insurance — Farmers Insurance Group is a Woodland Hills, California insurer that sells auto, home, life, motorcycle, recreational and business insurance through exclusive and independent agents.
  • Nationwide — Nationwide Mutual Insurance Company, headquartered in Columbus, Ohio, writes vehicle, property-and-casualty and life insurance.
  • The Hartford — The Hartford Insurance Group, Inc., based in Hartford, Connecticut, is a U.S. insurer that writes auto, home, property, liability, workers' compensation and employee-benefits cover, including auto and homeowners products for AARP members.

Topics

  • Liberty Mutual API
  • Liberty Mutual Mobile
  • insurance API
  • policy API
  • claims API
  • auto ID card data
  • RightTrack telematics API
  • billing details API
  • GraphQL insurance API
  • US insurance data

Need this app's data API integrated?

We deliver scoped integrations for any named app — from USD 500 with source-code handoff, or hosted access billed per call. Tell us the data you need.

  • NDA + SOW on every engagement
  • Delivery in 3–7 days
  • Payment only after acceptance
  • Work scoped to authorized use

Get a quote