curl --request POST \
--url https://app.unitedlogistics.com.do/api/v1/events \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"vehicle_external_id": 11964,
"fleet_id": 42,
"provider": "karma",
"external_message_id": 55001234,
"event_date": "2026-05-15T14:32:10.000Z",
"latitude": 18.4861,
"longitude": -69.9312,
"speed_kph": 62.5,
"heading_deg": 180,
"eid": 1
}
'{
"inserted": 2,
"skipped": 0,
"ids": [
987654321,
987654322
]
}{
"error": {
"code": "bad_request",
"message": "limit must be an integer between 1 and 500."
}
}{
"error": {
"code": "unauthorized",
"message": "API key missing or invalid."
}
}{
"error": {
"code": "forbidden",
"message": "API key lacks the required scope."
}
}{
"error": {
"code": "not_found",
"message": "Evento no encontrado."
}
}{
"error": {
"code": "too_many_requests",
"message": "Rate limit exceeded."
}
}Events
Create telemetry events
Inserts one event object or an array of up to 1000 events. Idempotent on (external_message_id, fleet_id) — duplicate rows are skipped. fleet_id and external_message_id are required on each event.
POST
/
events
curl --request POST \
--url https://app.unitedlogistics.com.do/api/v1/events \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '
{
"vehicle_external_id": 11964,
"fleet_id": 42,
"provider": "karma",
"external_message_id": 55001234,
"event_date": "2026-05-15T14:32:10.000Z",
"latitude": 18.4861,
"longitude": -69.9312,
"speed_kph": 62.5,
"heading_deg": 180,
"eid": 1
}
'{
"inserted": 2,
"skipped": 0,
"ids": [
987654321,
987654322
]
}{
"error": {
"code": "bad_request",
"message": "limit must be an integer between 1 and 500."
}
}{
"error": {
"code": "unauthorized",
"message": "API key missing or invalid."
}
}{
"error": {
"code": "forbidden",
"message": "API key lacks the required scope."
}
}{
"error": {
"code": "not_found",
"message": "Evento no encontrado."
}
}{
"error": {
"code": "too_many_requests",
"message": "Rate limit exceeded."
}
}Authorizations
Authorization: Bearer ulk__. Cree la clave en Configuración → API.
Body
application/json
- object
- object[]
Provider vehicle id (= vehicles.external_id).
Example:
12345
Fleet (provider account) scope. Required on each event; used for access validation.
Example:
1029
Telematics provider slug (e.g. karma, queclink, custom integrator slug).
Available options:
karma, internal Example:
"karma"
Provider message id. Required for idempotent bulk inserts; unique per fleet_id.
Example:
55001234
ISO 8601 timestamp when the event occurred.
Example:
"2026-05-15T14:32:10.000Z"
Maximum string length:
255Example:
"GPS-DEV-001"
Required range:
-90 <= x <= 90Required range:
-180 <= x <= 180Provider event-type code.
Example:
1
Required range:
x >= 0Required range:
0 <= x <= 360Required range:
x >= 0Opaque provider payload (driver key, raw extras, etc.).
Maximum string length:
4096