REST API Reference
All endpoints speak JSON. A Content-Type header with value application/json is expected to always be present.
The base url is https://api.sentiance.com/<version>/ for all REST endpoints, where the currently supported versions are v2 and v3. v1 has been fully deprecated. Note that not all APIs are common between v2 and v3 versions.
Note: The user deletion API is the only exception to the versioned endpoints rule. It stands on its own as DELETE /users/:user_id
For details on how to authenticate requests, have a look at the Authentication and Authorization page.
For other environments, please ask your sales representative or [email protected] for the custom endpoint linked to your environment.

V2 Endpoints

get
/v2/segment_definitions
Segment Definitions
get
/v2/moment_definitions
Moment Definitions
get
/v2/users/me
User's Own Profile
get
/v2/users/:user_id
Profile by User ID
get
/v2/users/:user_id/events?from=:from&to=:to
Timeline Events
get
/v2/users/:user_id/events/:start
Timeline Event by Start Time
get
/v2/users/:user_id/events/:start/trajectory
Trajectories by Start Time
get
/v2/users/:user_id/events/:start/behavior_scores
Behavior Scores by Start Time
get
/v2/users/:user_id/events/:start/behavior_annotations
Behavior Annotations by Start Time
get
/v2/users/:user_id/segments
User's Segments
get
/v2/users/:user_id/moments?from=:from&to=:to
Moment History
get
/v2/users/:user_id/active_moments
Active Moments
get
/v2/users/:user_id/location_clusters
Location Clusters
get
/v2/users/:user_id/location
Location
get
/v2/users/:user_id/car_behavior
Aggregated Behavior Scores
get
/v2/users/:user_id/anomalies?from=:from&to=:to
Anomaly History

V3 Endpoints

get
/v3/users/:user_id/events/:event_id
Timeline Event by EventId
get
/v3/users/:user_id/events/:event_id/trajectory
Trajectories by EventID
get
/v3/users/:user_id/events/:event_id/behavior_scores
Behavior Scores by EventID
get
/v3/users/:user_id/events/:event_id/behavior_annotations
Behavior Annotations by EventID
get
/v3/users/:user_id/aggregated_driving_scores
Time Aggregated Driving Scores

Unversioned Routes (no version prefix applied)

post
/users/auth-code
Authentication Code
delete
/users/:user_id
Delete User
Copy link
On this page
V2 Endpoints
get
Segment Definitions
get
Moment Definitions
get
User's Own Profile
get
Profile by User ID
get
Timeline Events
get
Timeline Event by Start Time
get
Trajectories by Start Time
get
Behavior Scores by Start Time
get
Behavior Annotations by Start Time
get
User's Segments
get
Moment History
get
Active Moments
get
Location Clusters
get
Location
get
Aggregated Behavior Scores
get
Anomaly History
post
User Link
V3 Endpoints
get
Timeline Event by EventId
get
Trajectories by EventID
get
Behavior Scores by EventID
get
Behavior Annotations by EventID
get
Time Aggregated Driving Scores
Unversioned Routes (no version prefix applied)
post
Authentication Code
delete
Delete User