Skip to main content
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
string
header
required

Authorization: Bearer ulk__. Cree la clave en Configuración → API.

Body

application/json
​
vehicle_external_id
integer
required

Provider vehicle id (= vehicles.external_id).

Example:

12345

​
fleet_id
integer
required

Fleet (provider account) scope. Required on each event; used for access validation.

Example:

1029

​
provider
required

Telematics provider slug (e.g. karma, queclink, custom integrator slug).

Available options:
karma,
internal
Example:

"karma"

​
external_message_id
integer
required

Provider message id. Required for idempotent bulk inserts; unique per fleet_id.

Example:

55001234

​
event_date
string<date-time>
required

ISO 8601 timestamp when the event occurred.

Example:

"2026-05-15T14:32:10.000Z"

​
device_id
string | null
Maximum string length: 255
Example:

"GPS-DEV-001"

​
latitude
number | null
Required range: -90 <= x <= 90
​
longitude
number | null
Required range: -180 <= x <= 180
​
eid
integer | null

Provider event-type code.

Example:

1

​
speed_kph
number | null
Required range: x >= 0
​
heading_deg
number | null
Required range: 0 <= x <= 360
​
odometer_km
number | null
Required range: x >= 0
​
altitude_m
number | null
​
engine_status
integer | null
​
ignition_status
integer | null
​
extra
string | null

Opaque provider payload (driver key, raw extras, etc.).

Maximum string length: 4096

Response

Created

​
inserted
integer
required
​
skipped
integer
required
​
ids
integer[]
required