Send an event

PUT

/partners/events/custom_events

Partner requests event and gets snapshot by device ID. The format of timestamp is YYYYmmDDHHMMSS, UTC, eg: 20170808150120.
If an event near the target timestamp (-10s or +10s) exists into the cloud storgae, the existing event id will be returned, and the response status code will be 202 or 201.
"custom_event_type" parameter contains information about event.

Roles with endpoint access

Role	Permission
Partner
Partner View
Custom Partner
Fleet Manager
Group Manager
User
Custom User

Request

Body Params multipart/form-data

Responses

🟢200200

application/json

Body

🟢200200 (device is offline)

🟠404404 (device is inactive)

🟠404404 (device doesn't exist)

🟠401Login Required

Request Example

Shell

JavaScript

Java

Swift

curl --location --request PUT '/partners/events/custom_events' \
--form 'device_id=""' \
--form 'timestamp="{{$date.recent|format('\''yyyyMMddHHmmss'\'')}}"' \
--form 'custom_event_type=""'

Response Example

200 - 200

{
    "meta": {
        "code": 200
    },
    "response": {
        "request_id": "int"
    },
    "result": "OK"
}

Modified at 2025-11-04 14:39:55

Get Company Events

Get snapshot/location of event