Documentation Index
Fetch the complete documentation index at: https://mintlify.com/JReyna217/AutoLog/llms.txt
Use this file to discover all available pages before exploring further.
The AutoLog dashboard gives you an at-a-glance summary of your vehicle’s performance and fuel spending without any manual calculation. It pulls from your logged fill-ups and exchange rate records to surface key metrics — including total monthly spending, fuel efficiency trends, and the latest USD/MXN rate — and prepares ready-to-render data series for four distinct charts. All data is scoped to the authenticated user and can be filtered to a specific vehicle, month, and year.
Dashboard Summary Metrics
The single GET /api/dashboard/summary endpoint returns a DashboardSummaryResponse object containing both scalar KPIs and chart-ready data arrays.
Scalar KPIs
| Field | Type | Description |
|---|
activeVehiclesCount | int | Total number of vehicles registered to the authenticated user |
latestExchangeRate | decimal? | The most recently recorded USD/MXN rate in the exchange rate catalog. null if no rates have been saved. |
totalMonthlySpending | decimal | Sum of TotalCostMxn across all fill-ups for the selected vehicle in the target month and year |
Chart Data Arrays
fullEfficiencyHistory — FuelPointDto[]
A chronological series of fuel efficiency data points used to render a line chart of km/L over time. Each point is calculated from a fill-up where DistanceTraveledKm > 0.
| Field | Type | Description |
|---|
date | DateTime | The date and time of the fill-up |
kmL | decimal | Fuel efficiency for that fill-up, calculated as DistanceTraveledKm / VolumeLiters, rounded to 2 decimal places |
annualEfficiencyComparison — MonthlyAverageDto[]
A grouped series for a year-over-year bar chart comparing average monthly efficiency. Each entry represents one calendar month across all logged years.
| Field | Type | Description |
|---|
year | int | The calendar year |
month | int | The calendar month (1–12) |
averageKmL | decimal | Average km/L across all fill-ups in that month and year, rounded to 2 decimal places |
monthlySpendingHistory — ChartDataPointDto[]
A time-ordered series of total monthly fuel spending in MXN, suitable for a bar or area chart showing spending trends.
| Field | Type | Description |
|---|
label | string | Month label formatted as MM/YYYY, e.g. "06/2025" |
value | decimal | Total TotalCostMxn for all fill-ups in that month |
exchangeRateHistory — ChartDataPointDto[]
The 30 most recent exchange rate records ordered chronologically, used to render a USD/MXN trend line chart.
| Field | Type | Description |
|---|
label | string | Date formatted as dd/MM/yyyy, e.g. "15/06/2025" |
value | decimal | The USD/MXN exchange rate recorded for that date |
Query Parameters
The summary endpoint accepts optional query parameters to filter results by vehicle, month, and year.
| Parameter | Type | Required | Description |
|---|
vehicleId | int | No | Filter all data to a specific vehicle. If omitted, the first vehicle on the user’s account is used. |
month | int | No | Target month for TotalMonthlySpending (1–12). Defaults to the month of the most recent fill-up. |
year | int | No | Target year for TotalMonthlySpending. Defaults to the year of the most recent fill-up. |
GET /api/dashboard/summary?vehicleId=3&month=3&year=2025
Always pass vehicleId when your user has more than one registered vehicle. Without it, the dashboard defaults to the first vehicle returned by the database, which may not be the one you want to analyze. Combine vehicleId with month and year to drill into any specific billing period.
Passing a vehicleId that belongs to a different user will result in an error response. The dashboard service verifies vehicle ownership against the authenticated user’s JWT claims before querying any fuel log data.
API Endpoint
| Method | Path | Description |
|---|
GET | /api/dashboard/summary | Fetch the full dashboard summary for the authenticated user |