# Get vehicle analytics

`GET https://api.parklio.com/v2/sessions/vehicle-analytics`

Returns paginated analytics grouped by license plate, including visit count, total/average/longest stay duration, and last seen time.

**Auth:** `Authorization: Bearer <token>`

## Query parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `sort` | string[] | no | Sort as `field:asc` or `field:desc`. Send it once. Fields: `plate`, `visits`, `total_time_seconds`, `avg_stay_seconds`, `longest_stay_seconds`, `last_seen`. See [Sorting](/api/conventions#sorting). |
| `page` | number | no | Page number, starting at 1. See [Paging](/api/conventions#paging). |
| `size` | number | no | Items per page: 10 by default, at most 300. See [Paging](/api/conventions#paging). |
| `filter` | string[] | no | Filter as `field:rule:value`, for example `lot_id:eq:7`. Repeat `filter` to combine filters; all must match. Fields: `created_at`, `plate`, `lot_ids`, `zone_ids`. See [Filtering](/api/conventions#filtering). |

## Responses

### 200 — Paginated vehicle analytics, grouped by plate.

```json
{
  "success": true,
  "data": [
    {
      "plate": "DTPLATE2",
      "vehicle_label": "Red Peugeot 206SW",
      "visits": 3,
      "total_time_seconds": 10800,
      "avg_stay_seconds": 5400,
      "longest_stay_seconds": 7200,
      "last_seen": "2026-08-24T14:00:00.000Z"
    }
  ],
  "meta": {
    "total": 1,
    "perPage": 10,
    "currentPage": 1,
    "lastPage": 1,
    "firstPage": 1,
    "firstPageUrl": "/?page=1",
    "lastPageUrl": "/?page=1",
    "nextPageUrl": null,
    "previousPageUrl": null
  }
}
```