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.

get

Authorizations

Bearer

AuthorizationstringRequired

Provide a JWT Bearer

Query parameters

UserTripReportTypeint32 · enumOptionalPossible values:

Responses

200

Success

application/json

differenceinteger · int32Optional

get

/api/v2/Trip/report

HTTPcURLJavaScriptPython

GET /api/v2/Trip/report HTTP/1.1
Host: api.artificient.de
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

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.

get

https://api.artificient.dehttps://api.gizo.pod.artificient.de

/api/v1/Trip/drivingScore

Authorizations

Bearer

AuthorizationstringRequired

Provide a JWT Bearer

Responses

200

Success

application/json

averageScoreinteger · int32Optional

get

/api/v1/Trip/drivingScore

HTTPcURLJavaScriptPython

GET /api/v1/Trip/drivingScore HTTP/1.1
Host: api.artificient.de
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

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.

get

Authorizations

Bearer

AuthorizationstringRequired

Provide a JWT Bearer

Query parameters

UserIdinteger · int64Optional

TripReportTypeint32 · enumOptionalPossible values:

Responses

200

Success

application/json

titlestring · nullableOptional

subtitlestring · nullableOptional

scoreinteger · int32Optional

differenceinteger · int32Optional

get

/api/v2/Trip/report/eventStats

HTTPcURLJavaScriptPython

GET /api/v2/Trip/report/eventStats HTTP/1.1
Host: api.artificient.de
Authorization: Bearer YOUR_SECRET_TOKEN
Accept: */*

200

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.