Performance
Report
The endpoint is designed to handle requests for generating a report of trips. It allows users to retrieve aggregated or summarized information about multiple trips based on certain criteria or filters.
Success
GET /api/v2/Trip/report HTTP/1.1
Host: api.artificient.de
Authorization: Bearer JWT
Accept: */*
Success
{
"difference": 1,
"items": [
{
"date": "2025-06-11T08:41:44.337",
"trips": 1,
"score": 1,
"distance": 1,
"duration": 1,
"label": "text"
}
]
}Header Request Parameters
Authentication Bearer Token
Request Query Parameters
UserTripReportType: it specifies the type of report scores, and is expected to be a numeric value, e.g. 1.
NOTE: the report type of DAILY will return 1, WEEKLY will return 2, and MONTHLY will return 3.
Response
The provided endpoint response contains an array of several properties, including:
difference: the performanse property provides a numerical value by comparing the scores based on the report type, e.g. 90.
items: the items property contains an array of items representing individual trips in the report. Each object within the items array represents a specific trip in the report, and the trip object includes the date, score ,and label information.
date: the date property represents a specific date and time of the report, which is formatted as "yyyy-MM-dd'T'HH:mm:ss.SSS", and it is expected to be a string value, e.g. "2023-08-29T00:00:00.000".
score: the score property represents a numerical score associated with the scores of all the user’s trips during the specific time, e.g. 91.5.
label: the label property represents a string or text label associated with the trip. It is expected to be a string value, e.g. "Tue".
NOTE: the label is determined based on the type of report. If the report type is DAILY, the label is the days of the week. For WEEKLY, it's the weeks of the year, and For MONTHLY, it's the months of the year.
Driving Score
The endpoint is designed to handle requests for retrieving or fetching the driving score information associated with a trip or journey. It allows users to access details about the driving performance or behavior during a specific trip.
Success
GET /api/v1/Trip/drivingScore HTTP/1.1
Host: api.artificient.de
Authorization: Bearer JWT
Accept: */*
Success
{
"averageScore": 1
}Header Request Parameters
Authentication Bearer Token
Response
The provided endpoint response contains a property, which is
averageScore: the averageScore property represents the average score gained from the all trips of the user. It is expected to be a numeric value, e.g. 95.
Event Stats
The endpoint is designed to handle requests for retrieving event statistics within a trip report. It allows users to access aggregated information and statistics related to specific events and incidents that occurred during trips or journeys.
Success
GET /api/v2/Trip/report/eventStats HTTP/1.1
Host: api.artificient.de
Authorization: Bearer JWT
Accept: */*
Success
[
{
"title": "text",
"subtitle": "text",
"score": 1,
"difference": 1
}
]Header Request Parameters
Authentication Bearer Token
Request Query Parameters
TripReportType: it specifies the type of report scores, and is expected to be a numeric value, e.g. 1.
NOTE: the report type of DAILY will return 1, WEEKLY will return 2, and MONTHLY will return 3.
Response
The provided endpoint response contains an array of several properties, including:
title: the title property represents a string or text that serves as a title or heading. It typically describes or identifies an event stats.
subtitle: the subtitle property represents a string or text that serves as a subtitle or secondary information related to the title. It provides additional details or context about the item or category.
score: the score property represents a numerical score associated with the item or category being described, e.g. 20.
difference: the difference property represents a numerical value indicating the difference or change related to the score. It provides information about how the score has changed for a particular report type compared to its previous value, e.g. 20.
Last updated