> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.datalbus.com.br/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.datalbus.com.br/_mcp/server.

# Eventos detalhados do dia

GET https://datalbus.com.br:8000/api/v2/reports/events/listDetailed

Lista todos os eventos de um dia, com dados do veículo, do motorista e da viagem.

Retorna o dia completo em um único array (sem paginação). Eventos do tipo histograma não são incluídos.

**Cabeçalho obrigatório:** `Time-Zone` (fuso IANA). Ele define o dia consultado e os horários da resposta.

**Resposta 200** (array). Cada item:

| Campo | Tipo | Nulo | Descrição |
| --- | --- | --- | --- |
| `anomaly_value_event` | boolean | sim | `true` quando o evento foi marcado com valor anômalo |
| `gps_low_quality` | boolean | sim | `true` quando o evento foi marcado com baixa qualidade de GPS |
| `trip_events_id` | integer | não | Id do evento |
| `license_number` | string | sim | Prefixo do veículo |
| `event_type_id` | integer | não | Tipo de evento (ver `GET /events-schema`) |
| `event_value` | number | sim | Valor medido no evento (ver tabela abaixo) |
| `model` | string | sim | Modelo do veículo |
| `vehicle_group` | string | sim | Grupo / garagem do veículo |
| `worker_id` | string | sim | Matrícula do motorista no momento do evento |
| `driver_name` | string | sim | Nome do motorista |
| `driver_group` | string | sim | Grupo do motorista |
| `start_drive` | string `YYYY-MM-DD HH:MM:SS` | não | Início da viagem |
| `mileage` | string (numérico) | sim | Distância da viagem (km) |
| `engine_hours` | string (numérico) | sim | Horas de motor da viagem |
| `fuel_used` | string (numérico) | sim | Combustível consumido na viagem |
| `idle_duration` | string | sim | Tempo parado com motor ligado na viagem |
| `trip_duration` | string | sim | Duração da viagem |
| `event_category_description` | string | sim | Nome do evento |
| `time` | string `YYYY-MM-DD HH:MM:SS` | não | Horário do evento |
| `drive_duration` | string `HH:MM:SS` | não | Duração do **evento** |
| `lat` | string (numérico) | sim | Latitude do evento (WGS-84) |
| `lon` | string (numérico) | sim | Longitude do evento (WGS-84) |
| `amount` | integer | não | Quantidade de ocorrências consolidadas no registro |
| `event_duration` | integer | sim | Duração do evento (segundos) |
| `geofence_names` | string | sim | Cerca em que o evento ocorreu |
| `cambio` | string | sim | Transmissão (`fabricante - nome - tipo`) |
| `license_plate` | string | sim | Placa do veículo |
| `total_mileage` | string (numérico) | sim | Odômetro da viagem (km) |
| `line_name` | string | sim | Linha operada (empresas com integração de linhas) |

**`event_value` por tipo de evento** (nos demais tipos, `null`):

| `event_type_id` | Valor |
| --- | --- |
| 2 | Velocidade máxima no excesso de velocidade |
| 7 | Velocidade na arrancada brusca |
| 9, 10, 11 | Pressão do óleo (baixa em marcha lenta, baixa em operação, alta) |
| 15 | Velocidade na frenagem brusca |
| 18 | Temperatura máxima do motor |
| 19 | Temperatura máxima do óleo |
| 29 | Duração com bateria baixa |
| 49, 50, 152 | Intensidade do desconforto lateral |
| -7 | Rotação do motor (RPM) |
| -8 | Posição do pedal do acelerador (%) |

**Erros:** `422` para `date` ausente ou inválido.

Reference: https://docs.datalbus.com.br/datalbus-api-v-2/relatorios/eventos-detalhados/eventos-detalhados-do-dia

## Authentication

- `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer <token>`, where token is your auth token.

## Request

### Query parameters

- `date` (string, optional) — Obrigatório. Dia consultado, formato `DD/MM/YYYY`.

### Headers

- `Time-Zone` (string, optional) — Obrigatório. Fuso horário IANA usado para definir o dia consultado e os horários da resposta.

## Response

### 200

OK

- `list of EventosDetalhadosDoDiaEventosDetalhadosResponseItem`

## Errors

### 401 Eventos Detalhados Do Dia Eventos Detalhados Request Unauthorized Error

Unauthorized

- `message` (string, required)

### 422 Eventos Detalhados Do Dia Eventos Detalhados Request Unprocessable Entity Error

Unprocessable Content

- `errors` (UnprocessableEntityErrorBodyErrors, required)
- `message` (string, required)

## Types

### EventosDetalhadosDoDiaEventosDetalhadosResponseItem

- `lat` (string, required)
- `lon` (string, required)
- `time` (string, required)
- `model` (string, required)
- `amount` (integer, required)
- `cambio` (string, required)
- `mileage` (string, required)
- `fuel_used` (string, required)
- `line_name` (string, required)
- `worker_id` (string, required)
- `driver_name` (string, required)
- `event_value` (double, required)
- `start_drive` (string, required)
- `driver_group` (string, required)
- `engine_hours` (string, required)
- `event_type_id` (integer, required)
- `idle_duration` (string, required)
- `license_plate` (string, required)
- `total_mileage` (string, required)
- `trip_duration` (string, required)
- `vehicle_group` (string, required)
- `drive_duration` (string, required)
- `event_duration` (integer, required)
- `geofence_names` (string, required)
- `license_number` (string, required)
- `trip_events_id` (integer, required)
- `gps_low_quality` (boolean, required)
- `anomaly_value_event` (boolean, required)
- `event_category_description` (string, required)

### UnprocessableEntityErrorBodyErrors

- `date` (list of string, required)
- `groupBy` (list of string, required)

## Examples

**Response**

```json
[
  {
    "lat": "-25.4301",
    "lon": "-49.2788",
    "time": "2026-10-06 05:47:13",
    "model": "O-500U",
    "amount": 1,
    "cambio": "Voith - DIWA - Automático",
    "mileage": "38.4",
    "fuel_used": "21.3",
    "line_name": "100 - Centro",
    "worker_id": "12345",
    "driver_name": "JOAO DA SILVA",
    "event_value": 72.5,
    "start_drive": "2026-10-06 05:12:40",
    "driver_group": "MOTORISTA - GP1",
    "engine_hours": "1.62",
    "event_type_id": 2,
    "idle_duration": "00:14:02",
    "license_plate": "ABC1D23",
    "total_mileage": "412345.7",
    "trip_duration": "01:37:10",
    "vehicle_group": "Garagem Norte",
    "drive_duration": "00:00:12",
    "event_duration": 12,
    "geofence_names": "Corredor Norte",
    "license_number": "1020",
    "trip_events_id": 845123901,
    "gps_low_quality": false,
    "anomaly_value_event": false,
    "event_category_description": "Excesso de velocidade"
  }
]
```

**SDK Code**

```python 200 - Eventos do dia
import requests

url = "https://datalbus.com.br:8000/api/v2/reports/events/listDetailed"

querystring = {"date":"06/10/2026"}

headers = {
    "Time-Zone": "America/Sao_Paulo",
    "Authorization": "Bearer <token>"
}

response = requests.get(url, headers=headers, params=querystring)

print(response.json())
```

```javascript 200 - Eventos do dia
const url = 'https://datalbus.com.br:8000/api/v2/reports/events/listDetailed?date=06%2F10%2F2026';
const options = {
  method: 'GET',
  headers: {'Time-Zone': 'America/Sao_Paulo', Authorization: 'Bearer <token>'}
};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}
```

```go 200 - Eventos do dia
package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://datalbus.com.br:8000/api/v2/reports/events/listDetailed?date=06%2F10%2F2026"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("Time-Zone", "America/Sao_Paulo")
	req.Header.Add("Authorization", "Bearer <token>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(res)
	fmt.Println(string(body))

}
```

```ruby 200 - Eventos do dia
require 'uri'
require 'net/http'

url = URI("https://datalbus.com.br:8000/api/v2/reports/events/listDetailed?date=06%2F10%2F2026")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Time-Zone"] = 'America/Sao_Paulo'
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
```

```java 200 - Eventos do dia
import com.mashape.unirest.http.HttpResponse;
import com.mashape.unirest.http.Unirest;

HttpResponse<String> response = Unirest.get("https://datalbus.com.br:8000/api/v2/reports/events/listDetailed?date=06%2F10%2F2026")
  .header("Time-Zone", "America/Sao_Paulo")
  .header("Authorization", "Bearer <token>")
  .asString();
```

```php 200 - Eventos do dia
<?php
require_once('vendor/autoload.php');

$client = new \GuzzleHttp\Client();

$response = $client->request('GET', 'https://datalbus.com.br:8000/api/v2/reports/events/listDetailed?date=06%2F10%2F2026', [
  'headers' => [
    'Authorization' => 'Bearer <token>',
    'Time-Zone' => 'America/Sao_Paulo',
  ],
]);

echo $response->getBody();
```

```csharp 200 - Eventos do dia
using RestSharp;

var client = new RestClient("https://datalbus.com.br:8000/api/v2/reports/events/listDetailed?date=06%2F10%2F2026");
var request = new RestRequest(Method.GET);
request.AddHeader("Time-Zone", "America/Sao_Paulo");
request.AddHeader("Authorization", "Bearer <token>");
IRestResponse response = client.Execute(request);
```

```swift 200 - Eventos do dia
import Foundation

let headers = [
  "Time-Zone": "America/Sao_Paulo",
  "Authorization": "Bearer <token>"
]

let request = NSMutableURLRequest(url: NSURL(string: "https://datalbus.com.br:8000/api/v2/reports/events/listDetailed?date=06%2F10%2F2026")! as URL,
                                        cachePolicy: .useProtocolCachePolicy,
                                    timeoutInterval: 10.0)
request.httpMethod = "GET"
request.allHTTPHeaderFields = headers

let session = URLSession.shared
let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in
  if (error != nil) {
    print(error as Any)
  } else {
    let httpResponse = response as? HTTPURLResponse
    print(httpResponse)
  }
})

dataTask.resume()
```