Skip to navigation
IntelligenceStop Detection

🧪 List Stop History for a Vehicle Near a Location

Retrieve detected stops for a specific vehicle at known places near the given coordinates. Finds all places whose centroid is within radius_m metres of the supplied lat/lon, then returns every stop this vehicle made at one of those places. Only stops matched to a known place are included — orphan stops are excluded. Results are ordered by start_date descending (most recent first).

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

vehicle_idstringRequiredformat: "uuid"

Query parameters

latdoubleRequired-90-90

Latitude of the target location (WGS 84, decimal degrees).

londoubleRequired-180-180

Longitude of the target location (WGS 84, decimal degrees).

radius_mdoubleOptional<=50000Defaults to 500

Search radius in metres. Places whose centroid falls within this distance of the given coordinates are included. Default: 500 m. Maximum: 50 000 m.

fleet_idslist of strings or nullOptional

Limit results to specific fleets using Catena’s fleet IDs. For your own fleet identifiers, use fleet_refs instead To specify multiple values, repeat the parameter for each value (e.g., ?fleet_ids=id1&fleet_ids=id2).

fleet_refslist of strings or nullOptional

Limit results to specific fleets using your organization’s fleet reference identifiers. To specify multiple values, repeat the parameter for each value (e.g., ?fleet_refs=ref1&fleet_refs=ref2).

connection_idstring or nullOptionalformat: "uuid"
Limit results to a specific provider connection. This is the UUID assigned by Catena when your fleet connects to a TSP.
active_from_datetimedatetime or nullOptional

Return only records that were still active at or after this date and time. Format: ISO 8601 (UTC) Applies filter: ended_at >= active_from_datetime

active_to_datetimedatetime or nullOptional

Return only records that started before this date and time. Format: ISO 8601 (UTC) Applies filter: started_at < active_to_datetime

known_stops_onlybooleanOptionalDefaults to false

When true, return only stops that have been matched to a known place (i.e. place_id is set). Orphan stops — those not yet attached to a place — are excluded.

stop_categorieslist of strings or nullOptional

Limit results to stops with one of the specified categories. To specify multiple values, repeat the parameter (e.g. ?stop_categories=FUEL&stop_categories=REST).

min_stop_duration_secondsinteger or nullOptional>=0

Return only stops whose duration is at least this many seconds. Long stops (no confirmed end) always pass this filter.

max_stop_duration_secondsinteger or nullOptional>=0

Return only stops whose duration is at most this many seconds. Long stops (no confirmed end) are excluded when this filter is active.

cursorstring or nullOptional
Cursor for the next page
sizeintegerOptional1-1000Defaults to 300
Page size

Response

Successful Response
itemslist of objects
totalinteger>=0
current_pagestring or nullOptional
Cursor to refetch the current page
current_page_backwardsstring or nullOptional
Cursor to refetch the current page starting from the last item
previous_pagestring or nullOptional
Cursor for the previous page
next_pagestring or nullOptional
Cursor for the next page

Errors

400
Bad Request Error
401
Unauthorized Error
403
Forbidden Error
404
Not Found Error
405
Method Not Allowed Error
409
Conflict Error
422
Unprocessable Entity Error
429
Too Many Requests Error
500
Internal Server Error
501
Not Implemented Error