Skip to main content

Data Validation Process

Your driving data is key to your Fairmatic Insurance plan - when your drivers are safe, you save. High-quality data gives you visibility into your drivers’ performance, which lets you manage and improve your risk over time and lets Fairmatic accurately and fairly price your premium.

To ensure the data is precise, we need your help in validating it.

Fairmatic uses the Fairmatic SDK for data collection and reporting once a week’s worth of data has been recorded. To ensure everything is working as it should, we ask our customers to provide us with data on a weekly basis. This data lets us ensure the SDK is implemented correctly and allows us to identify and resolve any issues quickly.

Validation workflow

Once the initial integration phase has begun, we’ll need the following data from you:

  • Format: CSV file (Sample File)
    • CSV filename should include the start timestamp and end timestamp, e.g. sampleDataValidation_1511791120_1511796887.csv
  • Required Data: Every Period1, Period2, and Period3 trip recorded from the application (See below for the specific data points that are needed for each trip.)
  • Duration: A minimum of 7 days of driving data
  • Frequency: Weekly

Reporting Format​

Each row in the CSV should represent one trip in the Period1, Period2, or Period3 insurance period and should include the following:

ItemDescriptionRelevant Methods
driver_id (String)The ID parameter used to initialize the Fairmatic SDK for a driver.
period (String)The insurance period for the trip. The period will be either "P2" or "P3".startDriveWithPeriod1(), startDriveWithPeriod2(), startDriveWithPeriod3()
start_timestamp (Integer)The epoch timestamp in seconds (GMT/UTC) when the insurance period trip is started. This is the time when the relevant startDrive method was called by the application.startDriveWithPeriod1(), startDriveWithPeriod2(), startDriveWithPeriod3()
end_timestamp (Integer)The epoch timestamp in seconds (GMT/UTC) when the insurance period trip is ended. This is the time when the stopPeriod method is called or the insurance period is changed by the application.startDriveWithPeriod1(), startDriveWithPeriod2(), startDriveWithPeriod3(), stopPeriod()
info

Please include all trips in the data sets, including cancelled trips, trips in which drivers may have been re-assigned in the middle of the trip, and others that may be different from the as-usual trip.

JavaDocs for the relevant methods mentioned above: