Nexus SoftSphereDocumentation

REST API for NexusFleet Manager

Every HTTP endpoint the application exposes, grouped by resource.

Calling the API

The API is served from the same address as the application, under /api. Requests carry the session cookie issued at sign-in, so a browser session and an API call are the same identity and obey the same permissions.

Every state changing request (POST, PUT, PATCH, DELETE) must also carry this application family's presence header, or it is refused with 403 bad request. That refusal reads like a permissions fault but is not one. Integration and APIs lists the header per family.

Endpoints

97 endpoints in 45 resource groups.

admin · alerts · analytics · assets · claims · coaching · command · compliance · connect · cost · custom-domain · dispatch · drivers · fines · fuel · health · jobs · live · login · logout · maint-schedules · maintenance · me · meta · next-number · nxdocs · nxdocs-file · nxtz · risk · routes · safety · scorecards · search · session · sso · sustainability · tco · telematics · telemetry · username · vehicles · video · video-events · work-orders · workforce

admin 5

MethodPathAccess
GET/api/admin/api-keysadministrator
POST/api/admin/api-keysadministrator
POST/api/admin/settingsadministrator
POST/api/admin/usersadministrator
POST/api/admin/users/:id/passwordadministrator

alerts 3

MethodPathAccess
POST/api/alerts/:id/acksigned in
POST/api/alerts/bulksigned in
POST/api/alerts/engine/runsigned in

analytics 2

MethodPathAccess
GET/api/analytics/dashboardsigned in
GET/api/analytics/report/:keysigned in

assets 1

MethodPathAccess
GET/api/assets/summarysigned in

claims 1

MethodPathAccess
POST/api/claims/from-incident/:idsigned in

coaching 1

MethodPathAccess
POST/api/coaching/from-eventssigned in

command 1

MethodPathAccess
GET/api/command/summarysigned in

compliance 5

MethodPathAccess
GET/api/compliance/audit-packsigned in
GET/api/compliance/expiringsigned in
GET/api/compliance/hos/:driverIdsigned in
POST/api/compliance/hos/certifysigned in
POST/api/compliance/inspectionsigned in

connect 25

MethodPathAccess
GET/api/connect/connectionssigned in
POST/api/connect/connectionssigned in
DELETE/api/connect/connections/:idsigned in
PUT/api/connect/connections/:idsigned in
POST/api/connect/connections/:id/callsigned in
POST/api/connect/connections/:id/testsigned in
GET/api/connect/hookssigned in
POST/api/connect/hookssigned in
DELETE/api/connect/hooks/:idsigned in
PUT/api/connect/hooks/:idsigned in
GET/api/connect/hooks/:id/eventssigned in
GET/api/connect/logsigned in
GET/api/connect/metasigned in
GET/api/connect/subssigned in
POST/api/connect/subssigned in
DELETE/api/connect/subs/:idsigned in
PUT/api/connect/subs/:idsigned in
POST/api/connect/subs/:id/testadministrator
GET/api/connect/tokenssigned in
POST/api/connect/tokenssigned in
DELETE/api/connect/tokens/:idsigned in
PUT/api/connect/tokens/:idsigned in
POST/connect/hook/:slugsigned in
GET/connect/mcpsigned in
POST/connect/mcpsigned in

cost 1

MethodPathAccess
GET/api/cost/summarysigned in

custom-domain 3

MethodPathAccess
GET/api/custom-domainsigned in
PUT/api/custom-domainadministrator
POST/api/custom-domain/verifyadministrator

dispatch 1

MethodPathAccess
GET/api/dispatch/boardsigned in

drivers 1

MethodPathAccess
GET/api/drivers/:id/profilesigned in

fines 1

MethodPathAccess
POST/api/fines/:id/nominatesigned in

fuel 2

MethodPathAccess
GET/api/fuel/efficiencysigned in
POST/api/fuel/scan-anomaliessigned in

health 1

MethodPathAccess
GET/api/healthsigned in

jobs 2

MethodPathAccess
POST/api/jobs/:id/assignsigned in
POST/api/jobs/:id/statussigned in

live 2

MethodPathAccess
GET/api/livesigned in
GET/api/live/nearestsigned in

login 2

MethodPathAccess
POST/api/loginpublic
POST/api/login/2fapublic

logout 1

MethodPathAccess
POST/api/logoutsigned in

maint-schedules 1

MethodPathAccess
POST/api/maint-schedules/:id/completesigned in

maintenance 2

MethodPathAccess
GET/api/maintenance/duesigned in
GET/api/maintenance/healthsigned in

me 3

MethodPathAccess
POST/api/me/passwordsigned in
GET/api/me/profilesigned in
PUT/api/me/profilesigned in

meta 1

MethodPathAccess
GET/api/metasigned in

next-number 1

MethodPathAccess
GET/api/next-numbersigned in

nxdocs 2

MethodPathAccess
GET/api/nxdocs/:kind/:refsigned in
POST/api/nxdocs/:kind/:refsigned in

nxdocs-file 2

MethodPathAccess
DELETE/api/nxdocs-file/:idsigned in
GET/api/nxdocs-file/:idsigned in

nxtz 3

MethodPathAccess
GET/api/nxtzsigned in
PUT/api/nxtzsigned in
POST/api/nxtz/devicesigned in

risk 1

MethodPathAccess
GET/api/risk/summarysigned in

routes 1

MethodPathAccess
POST/api/routes/:id/optimisesigned in

safety 2

MethodPathAccess
GET/api/safety/leaderboardsigned in
POST/api/safety/scorecards/generatesigned in

scorecards 1

MethodPathAccess
POST/api/scorecards/computesigned in
MethodPathAccess
GET/api/searchsigned in
GET/api/search/coveragesigned in

session 1

MethodPathAccess
GET/api/sessionsigned in

sso 1

MethodPathAccess
POST/api/sso/accountssigned in

sustainability 1

MethodPathAccess
GET/api/sustainability/summarysigned in

tco 1

MethodPathAccess
GET/api/tco/:vehicleIdsigned in

telematics 1

MethodPathAccess
GET/api/telematics/utilisationsigned in

telemetry 1

MethodPathAccess
POST/api/telemetrysigned in

username 1

MethodPathAccess
POST/api/username/forgotpublic

vehicles 1

MethodPathAccess
GET/api/vehicles/:id/replaysigned in

video 1

MethodPathAccess
GET/api/video/dossier/:idsigned in

video-events 1

MethodPathAccess
POST/api/video-events/:id/reviewsigned in

work-orders 3

MethodPathAccess
POST/api/work-orders/:id/closesigned in
GET/api/work-orders/:id/linessigned in
POST/api/work-orders/:id/linessigned in

workforce 1

MethodPathAccess
GET/api/workforce/summarysigned in