{
"opencollection": "1.0.0",
"info": {
"name": "Samsara Logs API",
"version": "2024-11-18"
},
"request": {
"auth": {
"type": "bearer",
"token": "{{bearerToken}}"
}
},
"items": [
{
"info": {
"name": "Logs",
"type": "folder"
},
"items": [
{
"info": {
"name": "Get All Driver HOS Daily Logs",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.samsara.com/fleet/hos/daily-logs",
"params": [
{
"name": "driverIds",
"value": "",
"type": "query",
"description": " A filter on the data based on this comma-separated list of driver IDs and externalIds. Example: `driverIds=1234,5678,payroll:4841`"
},
{
"name": "startDate",
"value": "",
"type": "query",
"description": " A start date in YYYY-MM-DD. This is a date only without an associated time. Example: `2019-06-13`. This is a required field"
},
{
"name": "endDate",
"value": "",
"type": "query",
"description": " An end date in YYYY-MM-DD. This is a date only without an associated time. Must be greater than or equal to the start date. Example: `2019-07-21`. This is a required field"
},
{
"name": "tagIds",
"value": "",
"type": "query",
"description": " A filter on the data based on this comma-separated list of tag IDs. Example: `tagIds=1234,5678`"
},
{
"name": "parentTagIds",
"value": "",
"type": "query",
"description": " A filter on the data based on this comma-separated list of parent tag IDs, for use by orgs with tag hierarchies. Specifying a parent tag will implicitly include all descendent tags of the parent tag. Example: `parentTagIds=345,678`"
},
{
"name": "driverActivationStatus",
"value": "",
"type": "query",
"description": "If value is `deactivated`, only drivers that are deactivated will appear in the response. This parameter will default to `active` if not provided (fetching only active drivers). Valid values: `active`, `deactivated`"
},
{
"name": "after",
"value": "",
"type": "query",
"description": " If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results."
},
{
"name": "expand",
"value": "",
"type": "query",
"description": "Expands the specified value(s) in the response object. Expansion populates additional fields in an object, if supported. Unsupported fields are ignored. To expand multiple fields, input a comma-separated list.\n\nValid value: `vehicle` Valid values: `vehicle`"
}
]
},
"docs": "Get summarized daily Hours of Service charts for the specified drivers.\n\nThe time range for a log is defined by the `driver`'s `eldDayStartHour`. This value is configurable per driver.\n\nThe `startDate` and `endDate` parameters indicate the date range you'd like to retrieve daily logs for. A daily log will be returned if its `startTime` is on any of the days within in this date range (inclusive of `startDate` and `endDate`).\n\n**Note:** If data is still being uploaded from the Samsara Driver App, "
},
{
"info": {
"name": "Get Route Updates",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.samsara.com/fleet/routes/audit-logs/feed",
"params": [
{
"name": "after",
"value": "",
"type": "query",
"description": " If specified, this should be the endCursor value from the previous page of results. When present, this request will return the next page of results that occur immediately after the previous page of results."
},
{
"name": "expand",
"value": "",
"type": "query",
"description": "Expands the specified value(s) in the response object. Expansion populates additional fields in an object, if supported. Unsupported fields are ignored. To expand multiple fields, input a comma-separated list.\n\nValid value: `route` Valid values: `route`"
}
]
},
"docs": "Subscribes to a feed of immutable, append-only updates for routes. The initial request to this feed endpoint returns a cursor, which can be used on the next request to fetch updated routes that have had state changes since that request.\n\nThe legacy version of this endpoint can be found at [samsara.com/api-legacy](https://www.samsara.com/api-legacy#operation/fetchAllRouteJobUpdates).\n\n Rate limit: 5 requests/sec (learn more about rate limits Rate limit: 5 requests/sec (learn more about rate limits here).\n\nTo use this endpoint, select **Write ELD Hours of Service (US)** under the Compliance category when creating or editing an API token. Learn More.\n \n\n **Submit Feedback**: Likes, dislikes, "
},
{
"info": {
"name": "Get HOS Signin and Signout",
"type": "http"
},
"http": {
"method": "GET",
"url": "https://api.samsara.com/v1/fleet/hos_authentication_logs",
"params": [
{
"name": "driverId",
"value": "",
"type": "query",
"description": "Driver ID to query."
},
{
"name": "startMs",
"value": "",
"type": "query",
"description": "Beginning of the time range, specified in milliseconds UNIX time."
},
{
"name": "endMs",
"value": "",
"type": "query",
"description": "End of the time range, specified in milliseconds UNIX time."
}
]
},
"docs": "\n\n\nThis endpoint is still on our legacy API.\n\n\n\nGet the HOS (hours of service) signin and signout logs for the specified driver. The response includes 4 fields that are now deprecated.\n\n**Note:** If data is still being uploaded from the Samsara Driver App, it may not be completely reflected in the response from this endpoint. The best practice is to wait a couple of days before querying this endpoint to make sure that all da"
}
]
}
],
"bundled": true
}