# Developers | Samsara Documentation ## Guides - [External IDs](https://developers.samsara.com/docs/external-ids.md): Reference objects using a custom identifier that you provide - [Response Codes](https://developers.samsara.com/docs/response-codes.md) - [REST API Overview](https://developers.samsara.com/docs/rest-api-overview.md): Learn about the main resources available through Samsara's API - [Versioning](https://developers.samsara.com/docs/versioning.md): Learn about API versions and backwards incompatible changes - [Addresses](https://developers.samsara.com/docs/addresses-guide.md): Create and manage known locations - [Assets: Vehicles, Trailers, and Equipment](https://developers.samsara.com/docs/assets-vehicles-trailers-equipment.md): Manage assets including vehicles, trailers, powered equipment, unpowered equipment, and more. - [Compliance & ELD](https://developers.samsara.com/docs/compliance-guide.md): Manage hours of service and records of duty status - [Driver-Vehicle Assignment FAQs](https://developers.samsara.com/docs/driver-vehicle-assignment-faqs.md) - [Drivers](https://developers.samsara.com/docs/drivers-guide.md): Create and manage drivers - [Create and assign forms](https://developers.samsara.com/docs/creating-forms.md): Digitize forms, build workflows, and automate processes for safer, more efficient operations. - [Form fields](https://developers.samsara.com/docs/field-types.md): Field types enable you to capture the correct type of data needed within your Forms. - [Form statuses](https://developers.samsara.com/docs/form-statuses.md): Track progress and categorize next steps for form submissions - [Forms with tables](https://developers.samsara.com/docs/forms-with-tables.md): Working with form submissions when a form template has a table field - [Forms](https://developers.samsara.com/docs/forms.md): Digitize your documentation and build custom workflows. - [Working with issues from forms](https://developers.samsara.com/docs/working-with-issues-from-forms.md): Monitor and retrieve issues submitted via forms, enabling real-time workflows and proactive resolution. - [Readings](https://developers.samsara.com/docs/readings.md): Snapshot, Historical or Feeds reading data - [Calculating Distance Traveled](https://developers.samsara.com/docs/calculating-distance-traveled-guide.md) - [Historical Report](https://developers.samsara.com/docs/telematics-history.md): GPS and diagnostic data in a historical report - [Telematics Sync](https://developers.samsara.com/docs/vehicle-stats-feed.md): GPS and diagnostic data for telematics synchronization - [Event-Triggered Compliance Training](https://developers.samsara.com/docs/compliance-events-training.md): Assign training courses based on HOS violations - [Training](https://developers.samsara.com/docs/training.md): Automate Training Assignments with Samsara APIs - [New Driver Training](https://developers.samsara.com/docs/new-driver-training.md): Assign training courses to onboard new drivers - [Event-Triggered Safety Training](https://developers.samsara.com/docs/safety-events-training.md): Assign training courses based on safety events - [Scheduling Training](https://developers.samsara.com/docs/scheduling-training.md): Assign training courses on a regular cadence - [Kafka asset readings](https://developers.samsara.com/docs/kafka-asset-readings.md): Kafka message payloads for asset readings - [Kafka streaming](https://developers.samsara.com/docs/kafka-connector.md): Review the complete list of supported data entities and data streaming parameters - [Kafka events](https://developers.samsara.com/docs/kafka-events.md): Kafka message payloads for event based data - [Streaming Data to Cloud Providers](https://developers.samsara.com/docs/streaming-data-to-cloud-providers.md) - [API Authentication](https://developers.samsara.com/docs/authentication.md): Generate an API token for your application - [OAuth 2.0](https://developers.samsara.com/docs/oauth-20.md): Recommended authentication mechanism for Marketplace Applications - [Developer Metrics](https://developers.samsara.com/docs/developer-metrics.md) - [Functions](https://developers.samsara.com/docs/functions.md) - [Quickstart](https://developers.samsara.com/docs/getting-started.md) - [OpenAPI Spec](https://developers.samsara.com/docs/openapi-spec.md) - [Client libraries and SDKs](https://developers.samsara.com/docs/sdks.md): Libraries and tools for interacting with your Samsara integration. - [Introducing new API endpoints](https://developers.samsara.com/docs/introducing-our-next-generation-api.md) - [App Certification Process](https://developers.samsara.com/docs/app-certification-process.md) - [Create and Manage Apps](https://developers.samsara.com/docs/marketplace-apps.md): Connect your solution to the Connected Operations Cloud. - [Multi-Region Deployment FAQ](https://developers.samsara.com/docs/multi-region-deployment-faq.md) - [Partner Developer Portal](https://developers.samsara.com/docs/partner-developer-portal.md): Your home as part of Samsara's growing ecosystem. - [Partner Support](https://developers.samsara.com/docs/partner-support.md) - [Samsara Integration Guide for FMC Partners](https://developers.samsara.com/docs/samsara-integration-guide-for-fmc-partners.md) - [Sandboxes](https://developers.samsara.com/docs/sandboxes.md) - [Application Process](https://developers.samsara.com/docs/application-process.md): Apply to be part of the Technology Partner Program - [Technology Partner Program](https://developers.samsara.com/docs/technology-partner-program.md): Reach the world’s most complex operations with Samsara. - [Integration Partner Terms](https://developers.samsara.com/docs/integration-partner-terms.md) - [Data Connectors](https://developers.samsara.com/docs/data-connectors.md): Extending the Capabilities of Your Data with Samsara's Easy-to-Use Suite of Data Connectors - [Power BI Connector](https://developers.samsara.com/docs/power-bi-connector-additional-guidance.md): Common questions and additional setup guidance for the Power BI Connector. - [Fuel Card Integration](https://developers.samsara.com/docs/fuel-card-integration.md): Learn how to build a Fuel Card Integration for the Samsara App Marketplace - [Human Capital Management (HCM)](https://developers.samsara.com/docs/human-capital-management-hcm.md): Create a Samsara API integration for payroll or time tracking. - [Insuretech](https://developers.samsara.com/docs/insuretech.md): Learn how to integrate Samsara data with insurtech software - [Maintenance & Fault Monitoring](https://developers.samsara.com/docs/maintenance-fault-monitoring-guide.md): Integrate with maintenance & work order systems by monitoring fault codes, managing digital vehicle inspection reports, and scheduling planned maintenance - [Tell Tale Statuses Monitoring](https://developers.samsara.com/docs/tell-tales-monitoring.md) - [Mileage and distance](https://developers.samsara.com/docs/mileage-and-distance.md): How to calculate mileage and distance traveled. - [Driver-dispatch messaging](https://developers.samsara.com/docs/driver-dispatch-messaging.md): Used to coordinate pickups, share updates, and clarify route instructions. - [Forms and workflows](https://developers.samsara.com/docs/forms-and-workflows.md): Adding forms workflows to your TMS integration - [Migrating from Documents to Forms](https://developers.samsara.com/docs/migrating-from-documents-to-forms.md) - [TMS integration](https://developers.samsara.com/docs/tms-integration.md): How to integrate Samsara with a Transport Management System (TMS) - [Creating Stop Tasks](https://developers.samsara.com/docs/creating-route-stop-tasks-via-api.md): Define tasks for a driver to complete using Samsara's Documents feature - [Creating Routes](https://developers.samsara.com/docs/creating-routes-via-api.md): Create and assign routes and configure route start and completion settings. - [Routing](https://developers.samsara.com/docs/routing-guide.md): Integrate route creation, assignment, and progress tracking with your TMS. - [Stop Locations](https://developers.samsara.com/docs/route-locations.md): Manage the location where a route stop is planned - [Y-splits (T-calls)](https://developers.samsara.com/docs/y-splits-t-calls.md): Learn how to handle planned and ad hoc Y-splits (T-calls) - [Compliance](https://developers.samsara.com/docs/tms-compliance.md): Fleets rely on **Samsara’s compliance features** to ensure drivers follow Hours of Service (HOS) and Tachograph regulations - [GPS asset tracking](https://developers.samsara.com/docs/tms-gps-tracking.md): Monitor asset locations and telematics for vehicles and trailers - [[Beta] AddressCreated Event Schema](https://developers.samsara.com/docs/addresscreated.md) - [[Beta] AddressDeleted Event Schema](https://developers.samsara.com/docs/addressdeleted.md) - [[Beta] AddressUpdated Event Schema](https://developers.samsara.com/docs/addressupdated.md) - [AlertIncident Event Schema](https://developers.samsara.com/docs/alertincident.md) - [[Beta] DocumentSubmitted Event Schema](https://developers.samsara.com/docs/documentsubmitted.md) - [[Beta] DriverCreated Event Schema](https://developers.samsara.com/docs/drivercreated.md) - [[Beta] DriverUpdated Event Schema](https://developers.samsara.com/docs/driverupdated.md) - [DvirSubmitted Event Schema](https://developers.samsara.com/docs/dvirsubmitted.md) - [[Beta] EngineFaultOff Event Schema](https://developers.samsara.com/docs/enginefaultoff.md) - [[Beta] EngineFaultOn Event Schema](https://developers.samsara.com/docs/enginefaulton.md) - [[Beta] FormSubmitted Event Schema](https://developers.samsara.com/docs/formsubmitted.md) - [[Beta] FormUpdated Event Schema](https://developers.samsara.com/docs/formupdated.md) - [[Beta] GatewayUnplugged Event Schema](https://developers.samsara.com/docs/gatewayunplugged.md) - [[Beta] GeofenceEntry Event Schema](https://developers.samsara.com/docs/geofenceentry.md) - [[Beta] GeofenceExit Event Schema](https://developers.samsara.com/docs/geofenceexit.md) - [Webhooks 2.0 Reference](https://developers.samsara.com/docs/event-subscriptions.md): Subscribe to events through webhooks - [[Beta] IssueCreated Event Schema](https://developers.samsara.com/docs/issuecreated.md) - [[Beta] MissingDvirPastDue Event Schema](https://developers.samsara.com/docs/missingdvirpastdue.md) - [[Beta] RouteStopArrival Event Schema](https://developers.samsara.com/docs/routestoparrival.md) - [[Beta] RouteStopDeparture Event Schema](https://developers.samsara.com/docs/routestopdeparture.md) - [[Beta] RouteStopEarlyLateArrival Event Schema](https://developers.samsara.com/docs/routestopearlylatearrival.md) - [[Beta] RouteStopEtaUpdated Event Schema](https://developers.samsara.com/docs/routestopetaupdated.md) - [[Beta] RouteStopResequence Event Schema](https://developers.samsara.com/docs/routestopresequence.md) - [SevereSpeedingEnded Event Schema](https://developers.samsara.com/docs/severespeedingended.md) - [SevereSpeedingStarted Event Schema](https://developers.samsara.com/docs/severespeedingstarted.md) - [[Beta] SpeedingEventEnded Event Schema](https://developers.samsara.com/docs/speedingeventended.md) - [[Beta] SpeedingEventStarted Event Schema](https://developers.samsara.com/docs/speedingeventstarted.md) - [[Beta] VehicleCreated Event Schema](https://developers.samsara.com/docs/vehiclecreated.md) - [[Beta] VehicleUpdated Event Schema](https://developers.samsara.com/docs/vehicleupdated.md) - [Webhooks for Marketplace Apps](https://developers.samsara.com/docs/webhooks-for-marketplace-apps.md): Create and manage webhook endpoints using the API for your marketplace app - [Event Subscriptions](https://developers.samsara.com/docs/event-subscriptions-webhooks.md): Subscribe to events through webhooks - [What are Webhooks?](https://developers.samsara.com/docs/webhooks.md): Get notifications when an event occurs in your Samsara account - [Alert Webhooks](https://developers.samsara.com/docs/webhook-reference.md) ## API Reference - [Create a new asset.](https://developers.samsara.com/reference/createasset.md): Create a new asset. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Assets** under the Assets category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Delete an existing asset.](https://developers.samsara.com/reference/deleteasset.md): Delete an existing asset. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Assets** under the Assets category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] List asset inputs data in an organization.](https://developers.samsara.com/reference/getassetsinputs.md): This endpoint will return data collected from the inputs of your organization's assets based on the time parameters passed in. Results are paginated. If you include an endTime, the endpoint will return data up until that point. If you don’t include an endTime, you can continue to poll the API real-time with the pagination cursor that gets returned on every call. The endpoint will only return data up until the endTime that has been processed by the server at the time of the original request. You will need to request the same [startTime, endTime) range again to receive data for assets processed after the original request time. This endpoint sorts data by time ascending. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Assets** under the Assets category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [List all assets.](https://developers.samsara.com/reference/listassets.md): List all assets. Up to 300 assets will be returned per page. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Assets** under the Assets category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Update an existing asset.](https://developers.samsara.com/reference/updateasset.md): Update an existing asset. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Assets** under the Assets category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [List current location for all assets](https://developers.samsara.com/reference/v1getallassetcurrentlocations.md): This endpoint is still on our legacy API. Fetch current locations of all assets. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Equipment Statistics** under the Equipment category when creating or editing an API token. Learn More. - [[Legacy] List all assets](https://developers.samsara.com/reference/v1getallassets.md): **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/listassets) instead. The endpoint will continue to function as documented.** Fetch all powered and unpowered equipment. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Equipment** under the Equipment category when creating or editing an API token. Learn More. - [List historical locations for a given asset](https://developers.samsara.com/reference/v1getassetlocation.md): This endpoint is still on our legacy API. List historical locations for a given asset. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Equipment Statistics** under the Equipment category when creating or editing an API token. Learn More. - [List stats for a given reefer](https://developers.samsara.com/reference/v1getassetreefer.md): This endpoint is still on our legacy API. Fetch the reefer-specific stats of an asset. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Trailers** under the Trailers category when creating or editing an API token. Learn More. - [List stats for all reefers](https://developers.samsara.com/reference/v1getassetsreefers.md): This endpoint is still on our legacy API. Fetches all reefers and reefer-specific stats. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Trailers** under the Trailers category when creating or editing an API token. Learn More. - [Retrieve a unit of equipment](https://developers.samsara.com/reference/getequipment.md): Retrieves the unit of equipment with the given Samsara ID. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Equipment** under the Equipment category when creating or editing an API token. Learn More. - [Get most recent locations for all equipment](https://developers.samsara.com/reference/getequipmentlocations.md): Returns last known locations for all equipment. This can be optionally filtered by tags or specific equipment IDs. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Equipment Statistics** under the Equipment category when creating or editing an API token. Learn More. - [Follow feed of equipment locations](https://developers.samsara.com/reference/getequipmentlocationsfeed.md): Follow a continuous feed of all equipment locations. Your first call to this endpoint will provide you with the most recent location for each unit of equipment and a `pagination` object that contains an `endCursor`. You can provide the `endCursor` to subsequent calls via the `after` parameter. The response will contain any equipment location updates since that `endCursor`. If `hasNextPage` is `false`, no updates are readily available yet. We'd suggest waiting a minimum of 5 seconds before requesting updates. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Equipment Statistics** under the Equipment category when creating or editing an API token. Learn More. - [Get historical equipment locations](https://developers.samsara.com/reference/getequipmentlocationshistory.md): Returns historical equipment locations during the given time range. This can be optionally filtered by tags or specific equipment IDs. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Equipment Statistics** under the Equipment category when creating or editing an API token. Learn More. - [Get most recent stats for all equipment](https://developers.samsara.com/reference/getequipmentstats.md): Returns the last known stats for all equipment. This can be optionally filtered by tags or specific equipment IDs. Rate limit: 150 requests/sec (learn more about rate limits here). **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Equipment Statistics** under the Equipment category when creating or editing an API token. Learn More. - [Follow a feed of equipment stats](https://developers.samsara.com/reference/getequipmentstatsfeed.md): Follow a continuous feed of all equipment stats. Your first call to this endpoint will provide you with the most recent stats for each unit of equipment and a `pagination` object that contains an `endCursor`. You can provide the `endCursor` to subsequent calls via the `after` parameter. The response will contain any equipment stats updates since that `endCursor`. If `hasNextPage` is `false`, no updates are readily available yet. Each stat type has a different refresh rate, but in general we'd suggest waiting a minimum of 5 seconds before requesting updates. Rate limit: 150 requests/sec (learn more about rate limits here). **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Equipment Statistics** under the Equipment category when creating or editing an API token. Learn More. - [Get historical equipment stats](https://developers.samsara.com/reference/getequipmentstatshistory.md): Returns historical equipment status during the given time range. This can be optionally filtered by tags or specific equipment IDs. Rate limit: 150 requests/sec (learn more about rate limits here). **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Equipment Statistics** under the Equipment category when creating or editing an API token. Learn More. - [List all equipment](https://developers.samsara.com/reference/listequipment.md): Returns a list of all equipment in an organization. - [List asset location and speed data in an organization.](https://developers.samsara.com/reference/getlocationandspeed.md): This endpoint will return asset locations and speed data that has been collected for your organization based on the time parameters passed in. Results are paginated. If you include an endTime, the endpoint will return data up until that point. If you don’t include an endTime, you can continue to poll the API real-time with the pagination cursor that gets returned on every call. The endpoint will only return data up until the endTime that has been processed by the server at the time of the original request. You will need to request the same [startTime, endTime) range again to receive data for assets processed after the original request time. This endpoint sorts the time-series data by device. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Vehicles** under the Vehicles category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get Readings History and Feed](https://developers.samsara.com/reference/getreadingshistory.md): Get the values of a reading for a set of entities within the specified time range. Returns a paginated response with data for the specified resource IDs where startTime <= happenedAtTime < endTime. If endTime is not set, the time of the request is used as the endTime. Related guide: [Readings](https://developers.samsara.com/docs/readings). Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Readings** under the Readings category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get Readings Snapshot](https://developers.samsara.com/reference/getreadingssnapshot.md): An endpoint to get the last value of a reading for a set of entities at the specified time. Related guide: [Readings](https://developers.samsara.com/docs/readings). Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Readings** under the Readings category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get Readings Definitions](https://developers.samsara.com/reference/listreadingsdefinitions.md): An introspection endpoint for discovering the set of readings including their name, description, data type, unit, and other metadata. Related guide: [Readings](https://developers.samsara.com/docs/readings). Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Readings** under the Readings category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get all sensors](https://developers.samsara.com/reference/v1getsensors.md): This endpoint is still on our legacy API. Get sensor objects. This method returns a list of the sensor objects in the Samsara Cloud and information about them. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Sensors** under the Equipment category when creating or editing an API token. Learn More. - [Get cargo status](https://developers.samsara.com/reference/v1getsensorscargo.md): This endpoint is still on our legacy API. Get cargo monitor status (empty / full) for requested sensors. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Sensors** under the Equipment category when creating or editing an API token. Learn More. - [Get door status](https://developers.samsara.com/reference/v1getsensorsdoor.md): This endpoint is still on our legacy API. Get door monitor status (closed / open) for requested sensors. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Sensors** under the Equipment category when creating or editing an API token. Learn More. - [Get sensor history](https://developers.samsara.com/reference/v1getsensorshistory.md): This endpoint is still on our legacy API. Get historical data for specified sensors. This method returns a set of historical data for the specified sensors in the specified time range and at the specified time resolution. Rate limit: 100 requests/min (learn more about rate limits here). **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Sensors** under the Equipment category when creating or editing an API token. Learn More. - [Get humidity](https://developers.samsara.com/reference/v1getsensorshumidity.md): This endpoint is still on our legacy API. Get humidity for requested sensors. This method returns the current relative humidity for the requested sensors. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Sensors** under the Equipment category when creating or editing an API token. Learn More. - [Get temperature](https://developers.samsara.com/reference/v1getsensorstemperature.md): This endpoint is still on our legacy API. Get temperature for requested sensors. This method returns the current ambient temperature (and probe temperature if applicable) for the requested sensors. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Sensors** under the Equipment category when creating or editing an API token. Learn More. - [Create a new driver-trailer assignment](https://developers.samsara.com/reference/createdrivertrailerassignment.md): Create a new driver-trailer assignment Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Write Assignments** under the Assignments category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get currently active driver-trailer assignments for driver.](https://developers.samsara.com/reference/getdrivertrailerassignments.md): Get currently active driver-trailer assignments for driver. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Assignments** under the Assignments category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Update an existing driver-trailer assignment.](https://developers.samsara.com/reference/updatedrivertrailerassignment.md): Update an existing driver-trailer assignment. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Write Assignments** under the Assignments category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [List trailer assignments for all trailers](https://developers.samsara.com/reference/v1getalltrailerassignments.md): This endpoint is still on our legacy API. Fetch trailer assignment data for all trailers in your organization. Rate limit: 25 requests/sec (learn more about rate limits here). **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Assignments** under the Assignments category when creating or editing an API token. Learn More. - [List trailer assignments for a given trailer](https://developers.samsara.com/reference/v1getfleettrailerassignments.md): This endpoint is still on our legacy API. Fetch trailer assignment data for a single trailer. Rate limit: 25 requests/sec (learn more about rate limits here). **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Assignments** under the Assignments category when creating or editing an API token. Learn More. - [Creates a new trailer asset](https://developers.samsara.com/reference/createtrailer.md): Creates a new trailer asset. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Trailers** under the Trailers category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Delete a trailer](https://developers.samsara.com/reference/deletetrailer.md): Delete a trailer with the given ID. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Trailers** under the Trailers category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Retrieve a trailer](https://developers.samsara.com/reference/gettrailer.md): Retrieve a trailer with given ID. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Trailers** under the Trailers category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [List all trailers](https://developers.samsara.com/reference/listtrailers.md): List all trailers. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Trailers** under the Trailers category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Update a trailer](https://developers.samsara.com/reference/updatetrailer.md): Update a trailer. **Note** this implementation of patch uses [the JSON merge patch](https://tools.ietf.org/html/rfc7396) proposed standard. This means that any fields included in the patch request will _overwrite_ fields which exist on the target resource. For arrays, this means any array included in the request will _replace_ the array that exists at the specified path, it will not _add_ to the existing array Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Trailers** under the Trailers category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Locations snapshot](https://developers.samsara.com/reference/getvehiclelocations.md): ***NOTE: The Vehicle Locations API is an older API that does not combine GPS data with onboard diagnostics. Try our new [Vehicle Stats API](ref:getvehiclestats) instead.*** Returns the last known location of all vehicles at the given `time`. If no `time` is specified, the current time is used. This can be optionally filtered by tags or specific vehicle IDs. Related guide: Vehicle Locations. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Vehicle Statistics** under the Vehicles category when creating or editing an API token. Learn More. - [Locations feed](https://developers.samsara.com/reference/getvehiclelocationsfeed.md): ***NOTE: The Vehicle Locations API is an older API that does not combine GPS data with onboard diagnostics. Try our new [Vehicle Stats API](ref:getvehiclestatsfeed) instead.*** Follow a continuous feed of all vehicle locations from Samsara Vehicle Gateways. Your first call to this endpoint will provide you with the most recent location for each vehicle and a `pagination` object that contains an `endCursor`. You can provide the `endCursor` to the `after` parameter of this endpoint to get location updates since that `endCursor`. If `hasNextPage` is `false`, no updates are readily available yet. We'd suggest waiting a minimum of 5 seconds before requesting updates. Related guide: Vehicle Locations. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Vehicle Statistics** under the Vehicle category when creating or editing an API token. Learn More. - [Historical locations](https://developers.samsara.com/reference/getvehiclelocationshistory.md): ***NOTE: The Vehicle Locations API is an older API that does not combine GPS data with onboard diagnostics. Try our new [Vehicle Stats API](ref:getvehiclestatshistory) instead.*** Returns all known vehicle locations during the given time range. This can be optionally filtered by tags or specific vehicle IDs. Related guide: Vehicle Locations. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Vehicle Statistics** under the Vehicle category when creating or editing an API token. Learn More. - [Stats snapshot](https://developers.samsara.com/reference/getvehiclestats.md): Returns the last known stats of all vehicles at the given `time`. If no `time` is specified, the current time is used. Related guide: Telematics. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Vehicle Statistics** under the Vehicles category when creating or editing an API token. Learn More. - [Stats feed](https://developers.samsara.com/reference/getvehiclestatsfeed.md): Follow a feed of vehicle stats. Your first call to this endpoint will provide you with the most recent stats for each vehicle and an `endCursor`. You can the provide the `endCursor` value to the `after` query parameter to get all updates since the last call you made. If `hasNextPage` is `false`, no new data is immediately available. You should wait a minimum of 5 seconds making a subsequent request. Related guide: Telematics. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Vehicle Statistics** under the Vehicles category when creating or editing an API token. Learn More. - [Historical stats](https://developers.samsara.com/reference/getvehiclestatshistory.md): Returns vehicle stats during the given time range for all vehicles. This can be optionally filtered by tags or specific vehicle IDs. Related guide: Telematics. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Vehicle Statistics** under the Vehicles category when creating or editing an API token. Learn More. - [Retrieve a vehicle](https://developers.samsara.com/reference/getvehicle.md): Get information about a specific vehicle. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Vehicles** under the Vehicles category when creating or editing an API token. Learn More. - [List all vehicles.](https://developers.samsara.com/reference/listvehicles.md): Returns a list of all vehicles. Rate limit: 25 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Vehicles** under the Vehicles category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Update a vehicle](https://developers.samsara.com/reference/updatevehicle.md): Updates the given Vehicle object. **Note:** Vehicle objects are automatically created when Samsara Vehicle Gateways are installed. You cannot create a Vehicle object via API. You are able to *update* many of the fields of a Vehicle. **Note**: There are no required fields in the request body, and you only need to provide the fields you wish to update. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Vehicles** under the Vehicles category when creating or editing an API token. Learn More. - [Get HOS clocks](https://developers.samsara.com/reference/gethosclocks.md): Get the current HOS status for all drivers. Note that this includes inactive as well as active drivers. The legacy version of this endpoint can be found at [samsara.com/api-legacy](https://www.samsara.com/api-legacy#operation/getFleetHosLogsSummary). **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read ELD Compliance Settings (US)** under the Compliance category when creating or editing an API token. Learn More. - [Get all driver HOS daily logs](https://developers.samsara.com/reference/gethosdailylogs.md): Get summarized daily Hours of Service charts for the specified drivers. The time range for a log is defined by the `driver`'s `eldDayStartHour`. This value is configurable per driver. The `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`). **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 data from the Samsara Driver App has been uploaded. If you are using the legacy version of this endpoint and looking for its documentation, you can find it [here](https://www.samsara.com/api-legacy#operation/getFleetDriversHosDailyLogs). Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read ELD Compliance Settings (US)** under the Compliance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get driver HOS ELD events](https://developers.samsara.com/reference/gethoseldevents.md): Get all HOS ELD events in a time range, grouped by driver. Attributes will be populated depending on which ELD Event Type is being returned. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read ELD Compliance Settings (US)** under the Compliance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get HOS logs](https://developers.samsara.com/reference/gethoslogs.md): Returns HOS logs between a given `startTime` and `endTime`. The logs can be further filtered using tags or by providing a list of driver IDs (including external IDs). The legacy version of this endpoint can be found at [samsara.com/api-legacy](https://www.samsara.com/api-legacy#operation/getFleetHosLogs). **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 data from the Samsara Driver App has been uploaded. Rate limit: 5 requests/sec (learn more about rate limits here). **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read ELD Compliance Settings (US)** under the Compliance category when creating or editing an API token. Learn More. - [Get all driver HOS violations](https://developers.samsara.com/reference/gethosviolations.md): Get active Hours of Service violations for the specified drivers. The day object time range for a violation is defined by the `driver`'s `eldDayStartHour`. This value is configurable per driver. The `startTime` and `endTime` parameters indicate the datetime range you'd like to retrieve violations for. A violation will be returned if its `violationStartTime` falls within this datetime range (inclusive of `startTime` and `endTime`) **Note:** The following are all the violation types with a short explanation about what each of them means: `californiaMealbreakMissed` (Missed California Meal Break), `cycleHoursOn` (Cycle Limit), `cycleOffHoursAfterOnDutyHours` (Cycle 2 Limit), `dailyDrivingHours` (Daily Driving Limit), `dailyOffDutyDeferralAddToDay2Consecutive` (Daily Off-Duty Deferral: Add To Day2 Consecutive), `dailyOffDutyDeferralNotPartMandatory` (Daily Off-Duty Deferral: Not Part Of Mandatory), `dailyOffDutyDeferralTwoDayDrivingLimit` (Daily Off-Duty Deferral: 2 Day Driving Limit), `dailyOffDutyDeferralTwoDayOffDuty` (Daily Off-Duty Deferral: 2 Day Off Duty), `dailyOffDutyNonResetHours` (Daily Off-Duty Time: Non-Reset), `dailyOffDutyTotalHours` (Daily Off-Duty Time), `dailyOnDutyHours` (Daily On-Duty Limit), `mandatory24HoursOffDuty` (24 Hours of Off Duty required), `restbreakMissed` (Missed Rest Break), `shiftDrivingHours` (Shift Driving Limit), `shiftHours` (Shift Duty Limit), `shiftOnDutyHours` (Shift On-Duty Limit), `unsubmittedLogs` (Missing Driver Certification) Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read ELD Compliance Settings (US)** under the Compliance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Set a duty status for a specific driver](https://developers.samsara.com/reference/setcurrentdutystatus.md): This endpoint is still on our legacy API. Set an individual driver’s current duty status to 'On Duty' or 'Off Duty'. To ensure compliance with the ELD Mandate, only authenticated drivers can make direct duty status changes on their own logbook. Any system external to the Samsara Driver App using this endpoint to trigger duty status changes must ensure that such changes are only triggered directly by the driver in question and that the driver has been properly authenticated. This endpoint should not be used to algorithmically trigger duty status changes nor should it be used by personnel besides the driver to trigger duty status changes on the driver’s behalf. Carriers and their drivers are ultimately responsible for maintaining accurate logs and should confirm that their use of the endpoint is compliant with the ELD Mandate. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write ELD Hours of Service (US)** under the Compliance category when creating or editing an API token. Learn More. - [Get HOS signin and signout](https://developers.samsara.com/reference/v1getfleethosauthenticationlogs.md): This endpoint is still on our legacy API. Get the HOS (hours of service) signin and signout logs for the specified driver. The response includes 4 fields that are now deprecated. **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 data from the Samsara Driver App has been uploaded. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read ELD Hours of Service (US)** under the Compliance category when creating or editing an API token. Learn More. - [Get driver tachograph activity](https://developers.samsara.com/reference/getdrivertachographactivity.md): Returns all known tachograph activity for all specified drivers in the time range. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Tachograph (EU)** under the Compliance category when creating or editing an API token. Learn More. - [Get tachograph driver files](https://developers.samsara.com/reference/getdrivertachographfiles.md): Returns all known tachograph files for all specified drivers in the time range. Rate limit: 50 requests/sec (learn more about rate limits here). **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Tachograph (EU)** under the Compliance category when creating or editing an API token. Learn More. - [Get tachograph vehicle files](https://developers.samsara.com/reference/getvehicletachographfiles.md): Returns all known tachograph files for all specified vehicles in the time range. Rate limit: 150 requests/sec (learn more about rate limits here). **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Tachograph (EU)** under the Compliance category when creating or editing an API token. Learn More. - [Create an address](https://developers.samsara.com/reference/createaddress.md): Creates a new address in the organization. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Addresses** under the Addresses category when creating or editing an API token. Learn More. - [Delete an address](https://developers.samsara.com/reference/deleteaddress.md): Delete a specific address. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Addresses** under the Addresses category when creating or editing an API token. Learn More. - [Retrieve an address](https://developers.samsara.com/reference/getaddress.md): Returns a specific address. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Addresses** under the Addresses category when creating or editing an API token. Learn More. - [List all addresses](https://developers.samsara.com/reference/listaddresses.md): Returns a list of all addresses in an organization. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Addresses** under the Addresses category when creating or editing an API token. Learn More. - [Update an address](https://developers.samsara.com/reference/updateaddress.md): Update a specific address. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Addresses** under the Addresses category when creating or editing an API token. Learn More. - [Delete alert configurations.](https://developers.samsara.com/reference/deleteconfigurations.md): Delete an alert configuration. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Alerts** under the Alerts category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get Alert Configurations.](https://developers.samsara.com/reference/getconfigurations.md): Get specified Alert Configurations. The following trigger types are API enabled and will show up in the results: Vehicle Speed Ambient Temperature Fuel Level (Percentage) Vehicle DEF Level (Percentage) Vehicle Battery Gateway Unplugged Dashcam Disconnected Camera Connector Disconnected Asset starts moving Inside Geofence Outside Geofence Unassigned Driving Driver HOS Violation Vehicle Engine Idle Asset Engine On Asset Engine Off Harsh Event Scheduled Maintenance Scheduled Maintenance by Odometer Scheduled Maintenance by Engine Hours Out of Route GPS Signal Loss Cell Signal Loss Fault Code Tire Faults Gateway Disconnected Panic Button Tampering Detected Asset Reading If vehicle is severely speeding (as defined by your organization) DVIR Submitted for Asset Driver Document Submitted Driver App Sign In Driver App Sign Out Geofence Entry Geofence Exit Route Stop ETA Alert Driver Recorded A safety event occurred with a driver assigned A safety event occurred Sudden Fuel Level Rise Sudden Fuel Level Drop Scheduled Date And Time Training Assignment Due Soon Training Assignment Past Due Asset assignment past due Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Alerts** under the Alerts category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get Alert Incidents.](https://developers.samsara.com/reference/getincidents.md): Get Alert Incidents for specific Alert Configurations over a specified period of time. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Alerts** under the Alerts category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Update alert configurations.](https://developers.samsara.com/reference/patchconfigurations.md): Updates an alert configuration. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Alerts** under the Alerts category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create alert configurations.](https://developers.samsara.com/reference/postconfigurations.md): Creates an alert configuration. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Alerts** under the Alerts category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create an attribute](https://developers.samsara.com/reference/createattribute.md): Creates a new attribute in the organization. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Attributes** under the Setup & Administration category when creating or editing an API token. Learn More. - [Deleting an attribute](https://developers.samsara.com/reference/deleteattribute.md): Delete an attribute by id, including all of its applications. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Attributes** under the Setup & Administration category when creating or editing an API token. Learn More. - [Retrieve an attribute](https://developers.samsara.com/reference/getattribute.md): Fetch an attribute by id, including all of its applications. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Attributes** under the Setup & Administration category when creating or editing an API token. Learn More. - [List all attributes by entity type](https://developers.samsara.com/reference/getattributesbyentitytype.md): Fetch all attributes in an organization associated with either drivers or assets. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Attributes** under the Setup & Administration category when creating or editing an API token. Learn More. - [Update an attribute](https://developers.samsara.com/reference/updateattribute.md): Updates an attribute in the organization. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Attributes** under the Setup & Administration category when creating or editing an API token. Learn More. - [Create a contact](https://developers.samsara.com/reference/createcontact.md): Add a contact to the organization. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Alert Contacts** under the Setup & Administration category when creating or editing an API token. Learn More. - [Delete a contact](https://developers.samsara.com/reference/deletecontact.md): Delete the given contact. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Alert Contacts** under the Setup & Administration category when creating or editing an API token. Learn More. - [Retrieve a contact](https://developers.samsara.com/reference/getcontact.md): Get a specific contact's information. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Alert Contacts** under the Setup & Administration category when creating or editing an API token. Learn More. - [List all contacts](https://developers.samsara.com/reference/listcontacts.md): Returns a list of all contacts in an organization. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Alert Contacts** under the Setup & Administration category when creating or editing an API token. Learn More. - [Update a contact](https://developers.samsara.com/reference/updatecontact.md): Update a specific contact's information. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Alert Contacts** under the Setup & Administration category when creating or editing an API token. Learn More. - [Deactivate a gateway](https://developers.samsara.com/reference/deletegateway.md): Deactivate a gateway Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Gateways** under the Setup & Administration category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [List all gateways](https://developers.samsara.com/reference/getgateways.md): List all gateways Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Gateways** under the Setup & Administration category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Activate a new gateway](https://developers.samsara.com/reference/postgateway.md): Activate a new gateway. To activate a device and associate it with your organization, enter its serial number. Each device's serial number can also be found on its label or packaging, or from your order confirmation email. A Not Found error could mean that the serial was not found or it has already been activated Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Gateways** under the Setup & Administration category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create Live Sharing Link](https://developers.samsara.com/reference/createlivesharinglink.md): Create Live Sharing Link. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Live Sharing Links** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Delete non-expired Live Sharing Link](https://developers.samsara.com/reference/deletelivesharinglink.md): Delete Live Sharing Link. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Live Sharing Links** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get Live Sharing Links](https://developers.samsara.com/reference/getlivesharinglinks.md): Returns all non-expired Live Sharing Links. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Live Sharing Links** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Update non-expired Live Sharing Link](https://developers.samsara.com/reference/updatelivesharinglink.md): Update Live Sharing Link. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Live Sharing Links** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get information about your organization](https://developers.samsara.com/reference/getorganizationinfo.md): Get information about your organization. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Org Information** under the Setup & Administration category when creating or editing an API token. Learn More. - [Get compliance settings](https://developers.samsara.com/reference/getcompliancesettings.md): Get organization's compliance settings, including carrier name, office address, and DOT number Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read ELD Compliance Settings (US)** under the Compliance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get driver app settings](https://developers.samsara.com/reference/getdriverappsettings.md): Get driver app settings. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Driver App Settings** under the Drivers category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get safety settings](https://developers.samsara.com/reference/getsafetysettings.md): Get safety settings Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Safety Events & Scores** under the Safety & Cameras category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Update compliance settings](https://developers.samsara.com/reference/patchcompliancesettings.md): Update organization's compliance settings, including carrier name, office address, and DOT number Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write ELD Compliance Settings (US)** under the Compliance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Update driver app settings](https://developers.samsara.com/reference/patchdriverappsettings.md): Update driver app settings. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Driver App Settings** under the Drivers category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create a tag](https://developers.samsara.com/reference/createtag.md): Create a new tag for the organization. This may include up to 20,000 tagged entities. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Tags** under the Setup & Administration category when creating or editing an API token. Learn More. - [Delete a tag](https://developers.samsara.com/reference/deletetag.md): Permanently deletes a tag. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Tags** under the Setup & Administration category when creating or editing an API token. Learn More. - [Retrieve a tag](https://developers.samsara.com/reference/gettag.md): Fetch a tag by id. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Tags** under the Setup & Administration category when creating or editing an API token. Learn More. - [List all tags](https://developers.samsara.com/reference/listtags.md): Return all of the tags for an organization. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Tags** under the Setup & Administration category when creating or editing an API token. Learn More. - [Update a tag](https://developers.samsara.com/reference/patchtag.md): Update an existing tag. **Note** this implementation of patch uses [the JSON merge patch](https://tools.ietf.org/html/rfc7396) proposed standard. This means that any fields included in the patch request will _overwrite_ fields which exist on the target resource. For arrays, this means any array included in the request will _replace_ the array that exists at the specified path, it will not _add_ to the existing array. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Tags** under the Setup & Administration category when creating or editing an API token. Learn More. - [Update a tag](https://developers.samsara.com/reference/replacetag.md): Update a tag with a new name and new members. This API call would replace all old members of a tag with new members specified in the request body. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Tags** under the Setup & Administration category when creating or editing an API token. Learn More. - [Get Trips Stream](https://developers.samsara.com/reference/gettrips.md): This endpoint will return trips that have been collected for your organization based on the time parameters passed in. Results are paginated. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Trips** under the Trips category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get vehicle trips](https://developers.samsara.com/reference/v1getfleettrips.md): This endpoint is still on our legacy API. Get historical trips data for specified vehicle. This method returns a set of historical trips data for the specified vehicle in the specified time range. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Vehicle Trips** under the Vehicles category when creating or editing an API token. Learn More. - [Create a user](https://developers.samsara.com/reference/createuser.md): Add a user to the organization. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Users** under the Setup & Administration category when creating or editing an API token. Learn More. - [Delete a user](https://developers.samsara.com/reference/deleteuser.md): Delete the given user. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Users** under the Setup & Administration category when creating or editing an API token. Learn More. - [Retrieve a user](https://developers.samsara.com/reference/getuser.md): Get a specific user's information. Users that have expired access will not be returned. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Users** under the Setup & Administration category when creating or editing an API token. Learn More. - [List all user roles](https://developers.samsara.com/reference/listuserroles.md): Returns a list of all user roles in an organization. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Users** under the Setup & Administration category when creating or editing an API token. Learn More. - [List all users](https://developers.samsara.com/reference/listusers.md): Returns a list of all users in an organization. Users that have expired access will not be returned. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Users** under the Setup & Administration category when creating or editing an API token. Learn More. - [Update a user](https://developers.samsara.com/reference/updateuser.md): Update a specific user's information. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Users** under the Setup & Administration category when creating or editing an API token. Learn More. - [Delete a webhook with the given ID](https://developers.samsara.com/reference/deletewebhook.md): Delete a webhook with the given ID. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Webhooks** under the Setup & Administration category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Retrieve a webhook with given ID](https://developers.samsara.com/reference/getwebhook.md): Retrieve a webhook with given ID. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Webhooks** under the Setup & Administration category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [List all webhooks belonging to a specific org.](https://developers.samsara.com/reference/listwebhooks.md): List all webhooks belonging to a specific org. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Webhooks** under the Setup & Administration category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Update a specific webhook's information.](https://developers.samsara.com/reference/patchwebhook.md): Update a specific webhook's information. **Note** this implementation of patch uses [the JSON merge patch](https://tools.ietf.org/html/rfc7396) proposed standard. This means that any fields included in the patch request will _overwrite_ fields which exist on the target resource. For arrays, this means any array included in the request will _replace_ the array that exists at the specified path, it will not _add_ to the existing array Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Webhooks** under the Setup & Administration category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create a webhook](https://developers.samsara.com/reference/postwebhooks.md): Create a webhook Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Webhooks** under the Setup & Administration category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create auth token for a driver](https://developers.samsara.com/reference/authtoken.md): Creates a short-lived auth token a driver can use to login. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Driver Auth Token** under the Drivers category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create new QR code for driver](https://developers.samsara.com/reference/createdriverqrcode.md): Assign a new QR code for the requested driver. Return error if an active QR code already exists. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Drivers** under the Drivers category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Revoke driver's QR code](https://developers.samsara.com/reference/deletedriverqrcode.md): Revoke requested driver's currently active QR code. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Drivers** under the Drivers category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get driver QR codes](https://developers.samsara.com/reference/getdriversqrcodes.md): Get details for requested driver(s) QR code, used for driver trip assignment. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Drivers** under the Drivers category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create a new driver-vehicle assignment](https://developers.samsara.com/reference/createdrivervehicleassignment.md): Assign vehicle drive-time to a driver via API. For a step-by-step instruction on how to leverage this endpoint, see [this guide](https://developers.samsara.com/docs/creating-driver-vehicle-assignments) Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Assignments** under the Assignments category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Delete API generated driver-vehicle assignments](https://developers.samsara.com/reference/deletedrivervehicleassignments.md): Delete driver assignments that were created using the `POST fleet/driver-vehicle-assignments` endpoint for the requested vehicle in the requested time range. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Assignments** under the Assignments category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get all driver-vehicle assignments](https://developers.samsara.com/reference/getdrivervehicleassignments.md): Get all driver-vehicle assignments for the requested drivers or vehicles in the requested time range. To fetch driver-vehicle assignments out of the vehicle trips' time ranges, assignmentType needs to be specified. Note: this endpoint replaces past endpoints to fetch assignments by driver or by vehicle. Visit [this migration guide](https://developers.samsara.com/docs/migrating-from-driver-vehicle-assignment-or-vehicle-driver-assignment-endpoints) for more information. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Assignments** under the Assignments category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Update API generated driver-vehicle assignments](https://developers.samsara.com/reference/updatedrivervehicleassignment.md): Update driver assignments that were created using the `POST fleet/driver-vehicle-assignments`. Vehicle Id, Driver Id, and Start Time must match an existing assignment. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Assignments** under the Assignments category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create a driver](https://developers.samsara.com/reference/createdriver.md): Add a driver to the organization. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Drivers** under the Drivers category when creating or editing an API token. Learn More. - [Retrieve a driver](https://developers.samsara.com/reference/getdriver.md): Get information about a driver. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Drivers** under the Drivers category when creating or editing an API token. Learn More. - [List all drivers](https://developers.samsara.com/reference/listdrivers.md): Get all drivers in organization. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Drivers** under the Drivers category when creating or editing an API token. Learn More. - [Sign out a driver](https://developers.samsara.com/reference/postdriverremotesignout.md): Sign out a driver from the Samsara Driver App To access this endpoint, your organization must have the Samsara Platform Premier license. Note: Sign out requests made while a logged-in driver does not have internet connection will not log the driver out. A success response will still be provided and the driver will be logged out once they have internet connection. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Driver Remote Signout** under the Drivers category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Update a driver](https://developers.samsara.com/reference/updatedriver.md): Update a specific driver's information. This can also be used to activate or de-activate a given driver by setting the driverActivationStatus field. If the driverActivationStatus field is 'deactivated' then the user can also specify the deactivatedAtTime. The deactivatedAtTime cannot be more than 6 months in the past and must not come before the dirver's latest active HOS log. It will be considered an error if deactivatedAtTime is provided with a driverActivationStatus of active. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Drivers** under the Drivers category when creating or editing an API token. Learn More. - [Send a message to a list of driver ids.](https://developers.samsara.com/reference/v1createmessages.md): This endpoint is still on our legacy API. Send a message to a list of driver ids. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Messages** under the Driver Workflow category when creating or editing an API token. Learn More. - [Get all messages.](https://developers.samsara.com/reference/v1getmessages.md): This endpoint is still on our legacy API. Get all messages. Rate limit: 100 requests/min (learn more about rate limits here). **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Messages** under the Driver Workflow category when creating or editing an API token. Learn More. - [Get Driver efficiency data grouped by drivers.](https://developers.samsara.com/reference/getdriverefficiencybydrivers.md): This endpoint will return driver efficiency data that has been collected for your organization and grouped by drivers based on the time parameters passed in. Results are paginated. **Note:** The data from this endpoint comes from the Driver Efficiency (Eco-Driving) Report. The existing [/fleet/drivers/efficiency](https://developers.samsara.com/reference/getdriverefficiency) endpoint has now been moved to Legacy. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Driver Efficiency** under the Fuel & Energy category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get Driver efficiency data grouped by vehicles.](https://developers.samsara.com/reference/getdriverefficiencybyvehicles.md): This endpoint will return driver efficiency data that has been collected for your organization and grouped by vehicle drivers used based on the time parameters passed in. Results are paginated. **Note:** The data from this endpoint comes from the Driver Efficiency (Eco-Driving) Report. The existing [/fleet/drivers/efficiency](https://developers.samsara.com/reference/getdriverefficiency) endpoint has now been moved to Legacy. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Driver Efficiency** under the Fuel & Energy category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get fuel and energy efficiency driver reports.](https://developers.samsara.com/reference/getfuelenergydriverreports.md): Get fuel and energy efficiency driver reports for the requested time range. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Fuel & Energy** under the Fuel & Energy category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get fuel and energy efficiency vehicle reports.](https://developers.samsara.com/reference/getfuelenergyvehiclereports.md): Get fuel and energy efficiency vehicle reports for the requested time range. Rate limit: 25 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Fuel & Energy** under the Fuel & Energy category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create a fuel purchase transaction.](https://developers.samsara.com/reference/postfuelpurchase.md): Create a fuel purchase transaction. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Fuel Purchase** under the Fuel & Energy category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get idling events.](https://developers.samsara.com/reference/getidlingevents.md): Get idling events for the requested time duration. **Note:** The data from this endpoint comes from the new Advanced Idling Report, which provides additional data fields for each idling event such as air temperature, geofence, PTO state and minimum idle time. This endpoint includes data from January 1, 2024. If you require additional historical data, you can access it via the [vehicle idling reports API](https://developers.samsara.com/reference/getvehicleidlingreports). Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Idling** under the Fuel & Energy category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[legacy] Get vehicle idling reports.](https://developers.samsara.com/reference/getvehicleidlingreports.md): **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/getidlingevents) instead. The endpoint will continue to function as documented.** Get all vehicle idling reports for the requested time duration. Rate limit: 25 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Fuel & Energy** under the Fuel & Energy category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create a job to generate csv files of IFTA mileage segments.](https://developers.samsara.com/reference/createiftadetailjob.md): Create a job to generate csv files of IFTA mileage segments. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write IFTA (US)** under the Compliance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get information about an existing IFTA detail job.](https://developers.samsara.com/reference/getiftadetailjob.md): Get information about an existing IFTA detail job. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read IFTA (US)** under the Compliance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get IFTA jurisdiction reports.](https://developers.samsara.com/reference/getiftajurisdictionreports.md): Get all jurisdiction IFTA reports for the requested time duration. Data is returned in your organization's defined timezone. **Note:** The most recent 72 hours of data may still be processing and is subject to change and latency, so it is not recommended to request data for the most recent 72 hours. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read IFTA (US)** under the Compliance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get IFTA vehicle reports.](https://developers.samsara.com/reference/getiftavehiclereports.md): Get all vehicle IFTA reports for the requested time duration. Data is returned in your organization's defined timezone. **Note:** The most recent 72 hours of data may still be processing and is subject to change and latency, so it is not recommended to request data for the most recent 72 hours. Rate limit: 25 requests/sec (learn more about rate limits here). To use this endpoint, select **Read IFTA (US)** under the Compliance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Archive a qualification record.](https://developers.samsara.com/reference/archivequalificationrecord.md): Archives an existing qualification record. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Qualification Records** under the Qualification Records category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Create a Function.](https://developers.samsara.com/reference/createfunction.md): Create a new Function with the given name, description, and configuration. The response includes a URL (`uploadPutUrl`) for uploading the function's code package. After uploading, call `POST /functions/{name}/deploy` to make the function runnable. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Functions** under the Functions category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Create a Functions storage file.](https://developers.samsara.com/reference/createfunctionstoragefile.md): Create a new file in Functions storage. Returns a presigned upload URL. Returns an error if the file already exists. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Functions Storage** under the Functions category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Create a custom report run](https://developers.samsara.com/reference/createreportrun.md): Triggers a new custom report run based on the provided configuration. Rate limit: 50 requests/hour (learn more about rate limits here). To use this endpoint, select **Write Custom Reports** under the Custom Reports category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Create a ridership passenger.](https://developers.samsara.com/reference/createridershippassenger.md): Create a new ridership passenger. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Ridership** under the Ridership category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Create a ridership route setup.](https://developers.samsara.com/reference/createridershiproutesetup.md): Create the passenger assignment setup for a route. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Ridership** under the Ridership category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Delete a Function.](https://developers.samsara.com/reference/deletefunction.md): Delete a Function by name. A Function that is currently configured as an action in a workflow config cannot be deleted. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Functions** under the Functions category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Delete a Functions storage file.](https://developers.samsara.com/reference/deletefunctionstoragefile.md): Delete a file from Functions storage by name. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Functions Storage** under the Functions category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Delete a route template](https://developers.samsara.com/reference/deletehubroutetemplate.md): Delete a route template by its unique identifier. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Write Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Delete a place](https://developers.samsara.com/reference/deleteplace.md): Deletes a place. Pass `placeId` (Samsara id) as a query parameter. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Places** under the Places category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Delete orders from a plan](https://developers.samsara.com/reference/deleteplanorders.md): Delete one or more orders from a plan. Pass either `orderIds` (a comma-separated list) or `deleteAll=true`; exactly one is required. Orders are automatically unassigned from their routes before deletion. **Beta:** This endpoint is in beta and is likely to change before being broadly available. Reach out to your Samsara Representative to have RoutePlanning APIs enabled for your organization. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Write Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Delete a preferred fuel station.](https://developers.samsara.com/reference/deletepreferredstation.md): Delete a preferred fuel station for your organization. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Fuel Purchase** under the Fuel & Energy category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Delete a qualification record.](https://developers.samsara.com/reference/deletequalificationrecord.md): Deletes an existing qualification record. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Qualification Records** under the Qualification Records category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Delete a ridership passenger.](https://developers.samsara.com/reference/deleteridershippassenger.md): Delete a ridership passenger by ID. The id query parameter accepts either a Samsara UUID or an external ID in key:value format (e.g. student:STU-001). Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Ridership** under the Ridership category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Delete a ridership route setup.](https://developers.samsara.com/reference/deleteridershiproutesetup.md): Delete the passenger assignment setup for a route. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Ridership** under the Ridership category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Deploy a Function.](https://developers.samsara.com/reference/deployfunction.md): Deploy the uploaded code package for the specified Function, making it runnable. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Functions** under the Functions category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get a list of AEMP equipment](https://developers.samsara.com/reference/getaempequipmentlist.md): Get a list of equipment following the AEMP ISO 15143-3 standard. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read AEMP** under the Equipment category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get custom report datasets](https://developers.samsara.com/reference/getdatasets.md): Get datasets for custom reports. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Custom Reports** under the Custom Reports category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get depreciation transactions.](https://developers.samsara.com/reference/getdepreciationtransactions.md): Returns depreciation and adjustment transactions for assets. Transactions are returned ordered by updatedAt in ascending order (oldest to newest). Use startTime parameter for incremental sync. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Assets** under the Assets category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Returns a list of all detections in an organization.](https://developers.samsara.com/reference/getdetections.md): This endpoint will return all detections detected by in-vehicle assets and associated metadata. To get core endpoint data, select View Safety Detection Log under the Safety & Cameras category when creating or editing an API token. If you include an endTime, the endpoint will return data up until that point. If you don’t include an endTime, you can continue to poll the API real-time with the pagination cursor that gets returned on every call. Results are paginated. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Detection Log** under the Safety & Cameras category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] List devices.](https://developers.samsara.com/reference/getdevices.md): Returns all installed cameras (CM3x), vehicle gateways (VGs), and asset gateways (AGs) and their health information within an organization. **Beta:** This endpoint is in beta and is likely to change before being broadly available. Reach out to your Samsara Representative to have Devices API enabled for your organization. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Devices** under the Devices category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get engine immobilizer states](https://developers.samsara.com/reference/getengineimmobilizerstates.md): Get the engine immobilizer states of the queried vehicles. If a vehicle has never had an engine immobilizer connected, there won't be any state returned for that vehicle. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Vehicle Immobilization** under the Vehicles category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get a Function.](https://developers.samsara.com/reference/getfunction.md): Retrieve the current state of an existing Function, including its configuration, code package status, and a `lastUpdateTimestampMs` value for use in subsequent PATCH requests. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Read Functions** under the Functions category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get Function logs.](https://developers.samsara.com/reference/getfunctionlogs.md): Retrieve paginated log entries for a specific Function within a given time range. Logs are produced during Function executions and can be filtered by text content. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Read Functions** under the Functions category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get a Function run.](https://developers.samsara.com/reference/getfunctionrun.md): Retrieve the execution summary for a specific Function run, identified by the correlationId returned from the start run endpoint. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Read Functions** under the Functions category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get a Functions storage file.](https://developers.samsara.com/reference/getfunctionstoragefile.md): Get a file from Functions storage by name. Returns file metadata and a presigned download URL. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Read Functions Storage** under the Functions category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Poll place deletions](https://developers.samsara.com/reference/getplacedeletions.md): Returns cursor-paginated deletion markers for soft-deleted places in the organization. Use for replication after DELETE /places. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Places** under the Places category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] List or batch-get places](https://developers.samsara.com/reference/getplaces.md): Returns places for the authorized organization. Supports cursor pagination or batch fetch by Samsara place ids via `placeIds` or by external ids via `externalIds` (mutually exclusive). Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Places** under the Places category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get a preferred fuel station.](https://developers.samsara.com/reference/getpreferredstation.md): Get a single preferred fuel station by ID. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Read Fuel Purchase** under the Fuel & Energy category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get a list of specified qualification records.](https://developers.samsara.com/reference/getqualificationrecords.md): Returns qualification records for the specified list of IDs. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Qualification Records** under the Qualification Records category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get a stream of filtered qualification records.](https://developers.samsara.com/reference/getqualificationrecordsstream.md): Returns all qualification records that have been created or modified for your organization based on the time parameters passed in. Results are paginated and are sorted by last modified date. If you include an endTime, the endpoint will return data up until that point (exclusive). If you don't include an endTime, the API will continue to poll with the pagination cursor that gets returned on every call. The hasNextPage response value will be true if there is no endTime specified and endCursor is nonempty. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Qualification Records** under the Qualification Records category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get a list of qualification types.](https://developers.samsara.com/reference/getqualificationtypes.md): Returns a list of qualification types for the specified list of IDs. If no IDs are provided, all qualification types will be returned. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Qualification Records** under the Qualification Records category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get custom report configs](https://developers.samsara.com/reference/getreportconfigs.md): Get report configs created in the organization. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Custom Reports** under the Custom Reports category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get custom report run data](https://developers.samsara.com/reference/getreportrundata.md): Get data for the given custom report run. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Custom Reports** under the Custom Reports category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get custom report runs](https://developers.samsara.com/reference/getreportruns.md): Get custom report runs created by the user. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Custom Reports** under the Custom Reports category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get a ridership passenger.](https://developers.samsara.com/reference/getridershippassenger.md): Get a single ridership passenger by ID. The ID can be a Samsara UUID or an external ID in `key:value` format. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Ridership** under the Ridership category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get a ridership route setup.](https://developers.samsara.com/reference/getridershiproutesetup.md): Get the passenger assignment setup for a route by route ID. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Ridership** under the Ridership category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get trailer stats feed](https://developers.samsara.com/reference/gettrailerstatsfeed.md): Follow a feed of trailer stats. The first call to this endpoint will provide the most recent stats for each trailer and an `endCursor`. Providing the `endCursor` value to the `after` query parameter will fetch all updates since the previous API call. If `hasNextPage` is false, no new data is immediately available. Please wait a minimum of 5 seconds before making a subsequent request. Rate limit: 25 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Trailer Statistics** under the Trailers category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get trailer stats history](https://developers.samsara.com/reference/gettrailerstatshistory.md): Returns trailer stats during the given time range for all trailers. This can be optionally filtered by tags or specific trailer IDs. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Trailer Statistics** under the Trailers category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get trailer stats](https://developers.samsara.com/reference/gettrailerstatssnapshot.md): Returns the last known stats of all trailers at the given `time`. If no `time` is specified, the current time is used. Rate limit: 25 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Trailer Statistics** under the Trailers category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Get voice agent session details](https://developers.samsara.com/reference/getvoicesessions.md): Returns full details — including the transcript, tool calls, lifecycle events, and a recording URL — for a batch of voice agent sessions identified by `ids`. Discover session IDs with GET /agent-studio/voice-sessions/stream. Up to 100 IDs may be requested per call; IDs that are not found are omitted from the response. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Read Agent Studio Voice Sessions** under the Closed Beta category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Stream voice agent session summaries](https://developers.samsara.com/reference/getvoicesessionsstream.md): Returns a paginated stream of voice agent session summaries, filterable by start time, agent, vehicle, driver, and status. Sessions are returned ordered by `happenedAtTime` descending (most recent first). Use this endpoint to discover sessions; pass the returned IDs to GET /agent-studio/voice-sessions to fetch full session details. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Read Agent Studio Voice Sessions** under the Closed Beta category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Gets work order templates.](https://developers.samsara.com/reference/getworkordertemplates.md): Gets work order templates. Optionally filter to specific template ids; ids that do not resolve to a template (e.g. deleted) are omitted from the response. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Work Orders** under the Work Orders category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [List CARB CTC vehicle collection history](https://developers.samsara.com/reference/listcarbctcvehiclehistory.md): Returns paginated collection history for a batch of vehicles enrolled in the CARB CTC program. Use vehicle IDs from the list enrolled vehicles endpoint. Optionally filter by time range. Results are ordered by happenedAtTime descending, with vehicle ID as a tiebreaker. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read CARB CTC Integration** under the CARB CTC Integration category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [List CARB CTC enrolled vehicles](https://developers.samsara.com/reference/listcarbctcvehicles.md): Returns a paginated list of vehicles enrolled in the CARB CTC program with their latest compliance status. Results can be filtered by tag IDs and test status. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read CARB CTC Integration** under the CARB CTC Integration category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] List driver app workflows](https://developers.samsara.com/reference/listdriverworkflows.md): List the driver app workflows configured for the organization. Use the returned workflow IDs to reference workflows from the driver create/update APIs or from the driver workflow assignment API. Workflows are organization-scoped and unique per organization. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Drivers** under the Drivers category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] List Functions storage files.](https://developers.samsara.com/reference/listfunctionsstoragefiles.md): List files in Functions storage for the organization. Returns file metadata and optionally includes presigned download or upload URLs. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Read Functions Storage** under the Functions category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] List route templates for a specific hub](https://developers.samsara.com/reference/listhubroutetemplates.md): Retrieve route templates for a specific hub. Optionally filter by route template ID or name. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] List all maintenance vendors.](https://developers.samsara.com/reference/listmaintenancevendors.md): Returns a paginated list of maintenance vendors in the organization. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Work Orders** under the Work Orders category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] List orders for a specific plan](https://developers.samsara.com/reference/listplanorders.md): Retrieve all orders for a specific plan, including both assigned and unassigned orders. **Beta:** This endpoint is in beta and is likely to change before being broadly available. Reach out to your Samsara Representative to have RoutePlanning APIs enabled for your organization. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] List preferred fuel stations.](https://developers.samsara.com/reference/listpreferredstations.md): List all preferred fuel stations for your organization. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Read Fuel Purchase** under the Fuel & Energy category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] List preventive maintenance schedules](https://developers.samsara.com/reference/listpreventivemaintenanceschedules.md): Returns a paginated list of preventive maintenance schedules for the organization. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Preventive Maintenance Schedules** under the Preventive Maintenance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] List ridership passengers.](https://developers.samsara.com/reference/listridershippassengers.md): List ridership passengers by tag. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Ridership** under the Ridership category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] List ridership route setups.](https://developers.samsara.com/reference/listridershiproutesetups.md): List all route setups for a ridership account. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Ridership** under the Ridership category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] List tachograph live data](https://developers.samsara.com/reference/listtachographlivedata.md): Returns the latest live tachograph data for drivers, including working state and driving rest times, sourced from real-time telemetry. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Tachograph (EU)** under the Compliance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] List upcoming preventive maintenance](https://developers.samsara.com/reference/listupcomingpreventivemaintenance.md): Returns a paginated list of upcoming preventive maintenance schedules for the organization's assets, enriched with live telemetry (current odometer, engine hours) and due-date projections. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Upcoming Preventive Maintenance** under the Preventive Maintenance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] List all vendor categories.](https://developers.samsara.com/reference/listvendorcategories.md): Returns the list of vendor categories available for maintenance vendors. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Work Orders** under the Work Orders category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Update an equipment](https://developers.samsara.com/reference/patchequipment.md): Update an equipment. **Note** this implementation of patch uses [the JSON merge patch](https://tools.ietf.org/html/rfc7396) proposed standard. This means that any fields included in the patch request will _overwrite_ fields which exist on the target resource. For arrays, this means any array included in the request will _replace_ the array that exists at the specified path, it will not _add_ to the existing array Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Equipment** under the Equipment category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Update a Function.](https://developers.samsara.com/reference/patchfunction.md): Update an existing Function's description and configuration. The request must include `lastUpdateTimestampMs`, which is the timestamp value obtained from a previous create or get response. The response includes a URL (`uploadPutUrl`) for uploading new code. After uploading, call `POST /functions/{name}/deploy` for the changes to be applied. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Functions** under the Functions category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Update a place](https://developers.samsara.com/reference/patchplace.md): Updates a place. Provide exactly one of query parameter `placeId` (Samsara id) or `externalId` (key:value). Only fields present in the JSON body are changed; omit a field to leave it unchanged. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Places** under the Places category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Update a preferred fuel station.](https://developers.samsara.com/reference/patchpreferredstation.md): Update a preferred fuel station for your organization. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Fuel Purchase** under the Fuel & Energy category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Update a qualification record.](https://developers.samsara.com/reference/patchqualificationrecord.md): Updates an existing qualification record. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Qualification Records** under the Qualification Records category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Update Safety Events](https://developers.samsara.com/reference/patchsafetyeventsv2batch.md): Asynchronously update eventState, context labels, and/or behavior labels for one or more Safety Events. Returns 202 Accepted immediately. State changes propagate asynchronously; use GET /safety-events to confirm updated state. If any safetyEventIds are not found, the entire request fails with 404 before any mutations are executed.If both eventState and label fields are provided, the two mutations execute serially and are not transactional — a label mutation failure will not roll back a successful state change. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Write Safety Events & Scores** under the Safety & Cameras category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Publish a driver app workflow to drivers](https://developers.samsara.com/reference/postdriverworkflowassignment.md): Publish or unpublish a driver app workflow to one or more drivers by their IDs. If a workflow is published to a driver who already has it, or unpublished from a driver who does not have it, the operation is a no-op for that driver. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Write Driver App Settings** under the Drivers category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Create a place](https://developers.samsara.com/reference/postplace.md): Creates a place. Supply either a polygon `geofence` (at least three vertices) or `radiusMeters` with `latitude` and `longitude`. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Places** under the Places category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Create a preferred fuel station.](https://developers.samsara.com/reference/postpreferredstation.md): Create a preferred fuel station for your organization. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Fuel Purchase** under the Fuel & Energy category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Create a qualification record.](https://developers.samsara.com/reference/postqualificationrecord.md): Creates a new qualification record. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Qualification Records** under the Qualification Records category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Ingest Readings](https://developers.samsara.com/reference/postreadings.md): Ingest new readings. This endpoint allows the ingestion of batches of readings. Ingesting readings is only supported for assets created using the POST /assets API endpoint with readingsIngestionEnabled set to true. To see a full list of readings available for ingestion use the GET readings definitions API. Readings that currently support ingestion (by category):
ingestible * `batteryVoltage` * `coolantTemp` * `ecuFuelLevelMillipercent` * `engineHours` * `engineRpm` * `engineState` (values: off | running | idling) * `faultCodes` * `fuelLevelPerc` * `gps` * `odometerEcu` * `oilPressure`
When ingesting GPS location data, use the readingID 'gps'. The value object must contain the following fields: 'latitude' (decimal degrees), 'longitude' (decimal degrees), and 'speed' (meters per second). Related guide: [Readings](https://developers.samsara.com/docs/readings). Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Write Readings** under the Readings category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Voice sign-in: resolve driver and create assignment](https://developers.samsara.com/reference/resolveassignmentbydetails.md): Resolves a driver by name within an organization via voice sign-in, then creates a driver-vehicle assignment via the Driver Assignment Service. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Assignments** under the Assignments category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Start a Function run.](https://developers.samsara.com/reference/startfunctionrun.md): Start an asynchronous run for the specified Function. This endpoint allows you to override parameters available at runtime. Rate limit: 2 requests/min (learn more about rate limits here). To use this endpoint, select **Write Functions** under the Functions category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Unarchive a qualification record.](https://developers.samsara.com/reference/unarchivequalificationrecord.md): Unarchives an existing qualification record. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Qualification Records** under the Qualification Records category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Update engine immobilizer state of a vehicle.](https://developers.samsara.com/reference/updateengineimmobilizerstate.md): Update the engine immobilizer state of a vehicle. This requires an engine immobilizer to be installed on the vehicle gateway. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Vehicle Immobilization** under the Vehicles category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Update a Functions storage file.](https://developers.samsara.com/reference/updatefunctionstoragefile.md): Get a presigned upload URL for overwriting an existing file in Functions storage. Returns an error if the file does not exist. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Functions Storage** under the Functions category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Update a ridership passenger.](https://developers.samsara.com/reference/updateridershippassenger.md): Update a ridership passenger by ID. All provided fields will overwrite existing values (PUT semantics). The id query parameter accepts either a Samsara UUID or an external ID in key:value format (e.g. student:STU-001). Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Ridership** under the Ridership category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Update a ridership route setup.](https://developers.samsara.com/reference/updateridershiproutesetup.md): Update (replace) the passenger assignment setup for a route. All existing assignments will be replaced with the provided assignments. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Ridership** under the Ridership category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Update the shippingDocs field of an existing assignment.](https://developers.samsara.com/reference/updateshippingdocs.md): Update the shippingDocs field of an existing assignment. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Write ELD Hours of Service (US)** under the Compliance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[preview] Create auth token for a driver](https://developers.samsara.com/reference/createdriverauthtoken.md): Creates a short-lived auth token for a driver. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Driver Auth Token** under the Drivers category when creating or editing an API token. Learn More. Endpoints in this section are in Preview. These APIs are not functional and are instead for soliciting feedback from our API users on the intended design of this API. Additionally, it is not guaranteed that we will be releasing an endpoint included in this section to production. This means that developers should **NOT** rely on these APIs to build business critical applications - Samsara may change the structure of a preview API's interface without versioning or any notice to API users. - When an endpoint becomes generally available, it will be announced in the API [changelog](https://developers.samsara.com/changelog). **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] List missing device recovery assets.](https://developers.samsara.com/reference/listdevicerecoverymissingassets.md): List all assets that are currently marked as missing for the organization. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Assets** under the Assets category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[preview] Lock a vehicle.](https://developers.samsara.com/reference/lockvehicle.md): Lock a vehicle. This requires a vehicle gateway with locking capabilities. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Vehicle Lock/Unlock** under the Vehicles category when creating or editing an API token. Learn More. Endpoints in this section are in Preview. These APIs are not functional and are instead for soliciting feedback from our API users on the intended design of this API. Additionally, it is not guaranteed that we will be releasing an endpoint included in this section to production. This means that developers should **NOT** rely on these APIs to build business critical applications - Samsara may change the structure of a preview API's interface without versioning or any notice to API users. - When an endpoint becomes generally available, it will be announced in the API [changelog](https://developers.samsara.com/changelog). **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Mark an asset as missing.](https://developers.samsara.com/reference/markassetmissing.md): Mark an asset as missing. Optionally specify a note and notification recipients who will receive email updates. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Assets** under the Assets category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Pair gateways to devices](https://developers.samsara.com/reference/pairgateways.md): Reassign one or more gateways to different devices in a single call. Mirrors the dashboard's "Pair Gateway" flow and accepts up to 50 gateway-device pairs per request. Works for any device type: vehicles, assets, equipment, trailers, industrial machines, and asset tags. By default, devices that the reassigned gateways were previously linked to remain in their current group. Pass `removeOrphanDevices: true` to move those orphaned devices to the unassigned group and clear their tags. The endpoint is currently in Beta and gated behind a feature configuration; contact your Samsara representative to enable access. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Gateways** under the Setup & Administration category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[preview] Create a tachograph file upload.](https://developers.samsara.com/reference/posttachographfileupload.md): Reserve a tachograph file upload and return a presigned URL. Upload the file bytes directly to the URL with the returned headers. The driver or device the file belongs to is resolved from the file contents after upload. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Tachograph (EU)** under the Compliance category when creating or editing an API token. Learn More. Endpoints in this section are in Preview. These APIs are not functional and are instead for soliciting feedback from our API users on the intended design of this API. Additionally, it is not guaranteed that we will be releasing an endpoint included in this section to production. This means that developers should **NOT** rely on these APIs to build business critical applications - Samsara may change the structure of a preview API's interface without versioning or any notice to API users. - When an endpoint becomes generally available, it will be announced in the API [changelog](https://developers.samsara.com/changelog). **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[beta] Mark an asset as recovered.](https://developers.samsara.com/reference/recoverasset.md): Mark a missing asset as recovered. Provide the recovery status, reason for being missing, and optional additional details. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Assets** under the Assets category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[preview] Unlock a vehicle.](https://developers.samsara.com/reference/unlockvehicle.md): Unlock a vehicle. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Vehicle Lock/Unlock** under the Vehicles category when creating or editing an API token. Learn More. Endpoints in this section are in Preview. These APIs are not functional and are instead for soliciting feedback from our API users on the intended design of this API. Additionally, it is not guaranteed that we will be releasing an endpoint included in this section to production. This means that developers should **NOT** rely on these APIs to build business critical applications - Samsara may change the structure of a preview API's interface without versioning or any notice to API users. - When an endpoint becomes generally available, it will be announced in the API [changelog](https://developers.samsara.com/changelog). **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create an asset](https://developers.samsara.com/reference/createindustrialasset.md): Create an asset with optional configuration parameters. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Equipment** under the Equipment category when creating or editing an API token. Learn More. - [[beta] Create a job](https://developers.samsara.com/reference/createjob.md): Creates a new job and returns it. To use this endpoint, select **Write Jobs** under the Equipment category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Delete an existing asset](https://developers.samsara.com/reference/deleteindustrialasset.md): Delete asset. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Equipment** under the Equipment category when creating or editing an API token. Learn More. - [[beta] Deletes an existing job](https://developers.samsara.com/reference/deletejob.md): Deletes an existing job. To use this endpoint, select **Write Jobs** under the Equipment category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Follow a real-time feed of data points for data inputs](https://developers.samsara.com/reference/getdatainputdatafeed.md): Follow a continuous feed of all data input data points. Your first call to this endpoint will provide you with the most recent data points for each data input and a `pagination` object that contains an `endCursor`. You can provide the `endCursor` to the `after` parameter of this endpoint to get data point updates since that `endCursor`. If `hasNextPage` is `false`, no updates are readily available yet. We suggest waiting a minimum of 5 seconds before requesting updates. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Equipment Statistics** under the Equipment category when creating or editing an API token. Learn More. - [List historical data points for data inputs](https://developers.samsara.com/reference/getdatainputdatahistory.md): Returns all known data points during the given time range for all data inputs. This can be filtered by optional tags, specific data input IDs or asset IDs. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Equipment Statistics** under the Equipment category when creating or editing an API token. Learn More. - [List most recent data points for data inputs](https://developers.samsara.com/reference/getdatainputdatasnapshot.md): Returns last known data points for all data inputs. This can be filtered by optional tags, specific data input IDs or asset IDs. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Equipment Statistics** under the Equipment category when creating or editing an API token. Learn More. - [List all data inputs](https://developers.samsara.com/reference/getdatainputs.md): Returns all data inputs, optionally filtered by tags or asset ids. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Equipment Statistics** under the Equipment category when creating or editing an API token. Learn More. - [List all assets](https://developers.samsara.com/reference/getindustrialassets.md): List all assets in the organization. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Equipment** under the Equipment category when creating or editing an API token. Learn More. - [[beta] Fetches all jobs](https://developers.samsara.com/reference/getjobs.md): Fetches jobs based on id/uuid or provided filters. To use this endpoint, select **Read Jobs** under the Equipment category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Fetch runs by camera](https://developers.samsara.com/reference/getvisionrunsbycamera.md): This endpoint is still on our legacy API. Fetch runs by camera. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Industrial** under the Industrial category when creating or editing an API token. Learn More. - [Writes to data outputs on an asset](https://developers.samsara.com/reference/patchassetdataoutputs.md): Writes values to multiple data outputs on an asset simultaneously. Only the provided data outputs will be updated. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Equipment Statistics** under the Equipment category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Update an asset](https://developers.samsara.com/reference/patchindustrialasset.md): Update an existing asset. Only the provided fields will be updated. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Equipment** under the Equipment category when creating or editing an API token. Learn More. - [[beta] Patches a job](https://developers.samsara.com/reference/patchjob.md): Patches an existing job and returns it. To use this endpoint, select **Write Jobs** under the Equipment category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Fetch industrial cameras](https://developers.samsara.com/reference/v1getcameras.md): This endpoint is still on our legacy API. Fetch all cameras. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Industrial** under the Industrial category when creating or editing an API token. Learn More. - [Get machines](https://developers.samsara.com/reference/v1getmachines.md): This endpoint is still on our legacy API. Get machine objects. This method returns a list of the machine objects in the Samsara Cloud and information about them. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Industrial** under the Industrial category when creating or editing an API token. Learn More. - [Get machine history](https://developers.samsara.com/reference/v1getmachineshistory.md): This endpoint is still on our legacy API. Get historical data for machine objects. This method returns a set of historical data for all machines. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Industrial** under the Industrial category when creating or editing an API token. Learn More. - [Fetch the latest run for a camera or program](https://developers.samsara.com/reference/v1getvisionlatestruncamera.md): Fetch the latest run for a camera or program by default. If startedAtMs is supplied, fetch the specific run that corresponds to that start time. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Industrial** under the Industrial category when creating or editing an API token. Learn More. - [Fetch industrial camera programs](https://developers.samsara.com/reference/v1getvisionprogramsbycamera.md): This endpoint is still on our legacy API. Fetch configured programs on the camera. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Industrial** under the Industrial category when creating or editing an API token. Learn More. - [Fetch runs](https://developers.samsara.com/reference/v1getvisionruns.md): This endpoint is still on our legacy API. Fetch runs. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Industrial** under the Industrial category when creating or editing an API token. Learn More. - [Fetch runs by camera and program](https://developers.samsara.com/reference/v1getvisionrunsbycameraandprogram.md): This endpoint is still on our legacy API. Fetch runs by camera and program. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Industrial** under the Industrial category when creating or editing an API token. Learn More. - [[beta] List driver efficiency](https://developers.samsara.com/reference/getdriverefficiency.md): Get all driver and associated vehicle efficiency data. This is a legacy endpoint, consider using this endpoint [/driver-efficiency/drivers](https://developers.samsara.com/reference/getdriverefficiencybydrivers) instead. The endpoint will continue to function as documented. Rate limit: 50 requests/sec (learn more about rate limits here). **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Fuel & Energy** under the Fuel & Energy category when creating or editing an API token. Learn More. - [[legacy] Get all vehicles assigned to a set of drivers](https://developers.samsara.com/reference/getdriversvehicleassignments.md): **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/getdrivervehicleassignments) instead. The endpoint will continue to function as documented.** Get all vehicle assignments for the requested drivers in the requested time range. The only type of assignment supported right now are assignments created through the driver app. Rate limit: 25 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Assignments** under the Assignments category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[legacy] Get all defects](https://developers.samsara.com/reference/getdvirdefects.md): **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/streamdefects) instead. The endpoint will continue to function as documented.** Returns a list of DVIR defects in an organization, filtered by creation time. The maximum time period you can query for is 30 days. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Defects** under the Maintenance category when creating or editing an API token. Learn More. - [[legacy] Get all DVIRs](https://developers.samsara.com/reference/getdvirhistory.md): **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/getdvirs) instead. The endpoint will continue to function as documented.** Returns a list of all DVIRs in an organization. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read DVIRs** under the Maintenance category when creating or editing an API token. Learn More. - [[legacy] Get all drivers assigned to a set of vehicles](https://developers.samsara.com/reference/getvehiclesdriverassignments.md): **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/getdrivervehicleassignments) instead. The endpoint will continue to function as documented.** Get all driver assignments for the requested vehicles in the requested time range. The only type of assignment supported right now are assignments created through the driver app. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Assignments** under the Assignments category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Delete a route](https://developers.samsara.com/reference/v1deletedispatchroutebyid.md): This endpoint is still on our legacy API. Delete a dispatch route and its associated jobs. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Routes** under the Driver Workflow category when creating or editing an API token. Learn More. - [Create a mechanic DVIR](https://developers.samsara.com/reference/createdvir.md): Creates a new mechanic DVIR in the organization. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write DVIRs** under the Maintenance category when creating or editing an API token. Learn More. - [Get a single DVIR defect by ID.](https://developers.samsara.com/reference/getdefect.md): Get a single DVIR defect by ID. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Defects** under the Maintenance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get DVIR defect types.](https://developers.samsara.com/reference/getdefecttypes.md): Get DVIR defect types. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Defect Types** under the Maintenance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get a single DVIR by ID.](https://developers.samsara.com/reference/getdvir.md): Get a single DVIR by ID. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read DVIRs** under the Maintenance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Stream DVIRs](https://developers.samsara.com/reference/getdvirs.md): Returns a history/feed of changed DVIRs by updatedAtTime between startTime and endTime parameters. In case of missing `endTime` parameter it will return a never ending stream of data. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read DVIRs** under the Maintenance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Stream DVIR defects.](https://developers.samsara.com/reference/streamdefects.md): Stream DVIR defects. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Defects** under the Maintenance category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Resolve a DVIR](https://developers.samsara.com/reference/updatedvir.md): Resolves a given DVIR by marking its `isResolved` field to `true`. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write DVIRs** under the Maintenance category when creating or editing an API token. Learn More. - [Update a defect](https://developers.samsara.com/reference/updatedvirdefect.md): Updates a given defect. Can be used to resolve a defect by marking its `isResolved` field to `true`. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Defects** under the Maintenance category when creating or editing an API token. Learn More. - [Get vehicles with engine faults or check lights](https://developers.samsara.com/reference/v1getfleetmaintenancelist.md): This endpoint is still on our legacy API. Get list of the vehicles with any engine faults or check light data. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read DVIRs** under the Maintenance category when creating or editing an API token. Learn More. - [Deletes a work order.](https://developers.samsara.com/reference/deleteworkorders.md): Deletes a work order. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Work Orders** under the Work Orders category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Gets service tasks.](https://developers.samsara.com/reference/getservicetasks.md): Gets service tasks. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Work Orders** under the Work Orders category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Gets work orders.](https://developers.samsara.com/reference/getworkorders.md): Gets work orders. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Work Orders** under the Work Orders category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Updates a work order.](https://developers.samsara.com/reference/patchworkorders.md): Updates a work order. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Work Orders** under the Work Orders category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Process an invoice scan.](https://developers.samsara.com/reference/postinvoicescan.md): Process an invoice scan to create or update a work order with AI-extracted data. Accepts base64 encoded invoice files (PDF, JPEG, PNG) up to 10MB. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Work Orders** under the Work Orders category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Creates a work order.](https://developers.samsara.com/reference/postworkorders.md): Creates a work order. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Work Orders** under the Work Orders category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Stream work orders.](https://developers.samsara.com/reference/streamworkorders.md): Stream work orders. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Work Orders** under the Work Orders category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create locations in bulk](https://developers.samsara.com/reference/createhublocations.md): Create new locations. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create orders in bulk](https://developers.samsara.com/reference/createplanorders.md): Create one or more orders (bulk upsert). Pass an array of order objects; any object whose customerOrderId already exists will be updated, otherwise a new order is created. Functions can return JSON arrays in this Order POST format. Orders are initially created at the plan level but will migrate to hub-level entities, with planId becoming optional in future versions. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Write Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [List capacities for a specific hub](https://developers.samsara.com/reference/listhubcapacities.md): Retrieve capacity types for a specific hub. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [List custom properties for a specific hub](https://developers.samsara.com/reference/listhubcustomproperties.md): Retrieve custom properties for a specific hub. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [List locations for a specific hub](https://developers.samsara.com/reference/listhublocations.md): Retrieve locations for a specific hub. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [List all hubs for the organization](https://developers.samsara.com/reference/listhubs.md): Retrieve all hubs (planners) in the organization. This endpoint supports pagination and filtering based on hub IDs and update times. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [List skills for a specific hub](https://developers.samsara.com/reference/listhubskills.md): Retrieve skills for a specific hub. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Update a location](https://developers.samsara.com/reference/updatehublocation.md): Update existing location by ID. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create a new plan](https://developers.samsara.com/reference/createhubplan.md): Create a new plan. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Write Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [List routes for a specific plan](https://developers.samsara.com/reference/listhubplanroutes.md): Retrieve routes for a specific plan. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [List plans for a specific hub](https://developers.samsara.com/reference/listhubplans.md): Retrieve all plans for a specific hub. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get route events stream](https://developers.samsara.com/reference/getrouteeventsstream.md): 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 in subsequent requests to fetch events on all routes that occurred after the last retrieved event. An initial request (with empty after and startTime parameters) will return events from the past 24 hours. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create a route](https://developers.samsara.com/reference/createroute.md): Create a route. The legacy version of this endpoint can be found at [samsara.com/api-legacy](https://www.samsara.com/api-legacy#operation/createDispatchRoute). Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Delete a route.](https://developers.samsara.com/reference/deleteroute.md): Delete a dispatch route and its associated stops. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Fetch a route](https://developers.samsara.com/reference/fetchroute.md): Returns a single route. The legacy version of this endpoint can be found at [samsara.com/api-legacy](https://www.samsara.com/api-legacy#operation/getDispatchRouteById). Rate limit: 25 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Fetch all routes](https://developers.samsara.com/reference/fetchroutes.md): Returns multiple routes. The legacy version of this endpoint can be found at [samsara.com/api-legacy](https://www.samsara.com/api-legacy#operation/fetchAllDispatchRoutes). Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get route updates](https://developers.samsara.com/reference/getroutesfeed.md): 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. The legacy version of this endpoint can be found at [samsara.com/api-legacy](https://www.samsara.com/api-legacy#operation/fetchAllRouteJobUpdates). Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Update a route](https://developers.samsara.com/reference/patchroute.md): Update a route. **Note** this implementation of patch uses [the JSON merge patch](https://tools.ietf.org/html/rfc7396) proposed standard. This means that any fields included in the patch request will _overwrite_ fields which exist on the target resource. For arrays, this means any array included in the request will _replace_ the array that exists at the specified path, it will not _add_ to the existing array. The legacy version of this endpoint (which uses PUT instead of PATCH) can be found at [samsara.com/api-legacy](https://www.samsara.com/api-legacy#operation/updateDispatchRouteById). Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Routes** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get coaching sessions.](https://developers.samsara.com/reference/getcoachingsessions.md): This endpoint will return coaching sessions for your organization based on the time parameters passed in. Results are paginated by sessions. If you include an endTime, the endpoint will return data up until that point. If you don’t include an endTime, you can continue to poll the API real-time with the pagination cursor that gets returned on every call. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Coaching** under the Coaching category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get driver coach assignments.](https://developers.samsara.com/reference/getdrivercoachassignment.md): This endpoint will return coach assignments for your organization based on the parameters passed in. Results are paginated. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Coaching** under the Coaching category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Put driver coach assignments.](https://developers.samsara.com/reference/putdrivercoachassignment.md): This endpoint will update an existing or create a new coach-to-driver assignment for your organization based on the parameters passed in. This endpoint should only be used for existing Coach to Driver assignments. In order to remove a driver-coach-assignment for a given driver, set coachId to null Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Write Coaching** under the Coaching category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get a list of filtered training courses.](https://developers.samsara.com/reference/gettrainingcourses.md): Returns all training courses data. Results are paginated. Courses in the ‘draft’ status are excluded from the data returned by this endpoint. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Training Courses** under the Training Courses category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get details for a media retrieval request](https://developers.samsara.com/reference/getmediaretrieval.md): This endpoint returns media information corresponding to a retrieval ID. Retrieval IDs are associated to prior [media retrieval requests](https://developers.samsara.com/reference/postmediaretrieval). Urls provided by this endpoint expire in 8 hours. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Media Retrieval** under the Safety & Cameras category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [List uploaded media by time range.](https://developers.samsara.com/reference/listuploadedmedia.md): This endpoint returns a list of all uploaded media (video and still images) matching query parameters, with a maximum query range of one day. Additional media can be retrieved with the [Create a media retrieval request](https://developers.samsara.com/reference/postmediaretrieval) endpoint, and they will be included in the list after they are uploaded. Urls provided by this endpoint expire in 8 hours. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Media Retrieval** under the Safety & Cameras category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create a media retrieval request](https://developers.samsara.com/reference/postmediaretrieval.md): This endpoint creates an asynchronous request to upload certain media from a device. The closest available media to the requested timestamp is returned. Images, videos(both high resolution and low resolution) and hyperlapses are supported.Currently, only unblurred media is supported. If a device is offline, the requested media will be uploaded once it comes back online. Quota limits are enforced for media retrievals made through the API. The Create a media retrieval request response includes information about the media retrieval quota remaining for the organization. The media retrieval quota for the organization is reset at the beginning of each month.The quota is expressed using seconds of High Resolution video. 10 still images are equivalent to a 1 second of High Resolution footage. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Media Retrieval** under the Safety & Cameras category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[legacy] Fetches safety activity event feed](https://developers.samsara.com/reference/getsafetyactivityeventfeed.md): **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/getsafetyeventsv2stream) instead. The endpoint will continue to function as documented.** Get continuous safety events. The safety activity event feed offers a change-log for safety events. Use this endpoint to subscribe to safety event changes. See documentation below for all supported change-log types. | ActivityType | Description | | ----------- | ----------- | | CreateSafetyEventActivityType | a new safety event is processed by Samsara | | BehaviorLabelActivityType | a label is added or removed from a safety event | | CoachingStateActivityType | a safety event coaching state is updated | Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Safety Events & Scores** under the Safety & Cameras category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [[legacy] List all safety events.](https://developers.samsara.com/reference/getsafetyevents.md): **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/getsafetyeventsv2stream) instead. The endpoint will continue to function as documented.** Fetch safety events for the organization in a given time period. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Safety Events & Scores** under the Safety & Cameras category when creating or editing an API token. Learn More. - [Get Safety Events](https://developers.samsara.com/reference/getsafetyeventsv2.md): This endpoint will return details for the specified safety events based on the parameters passed in. Results are paginated. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Safety Events & Scores** under the Safety & Cameras category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get Safety Events Stream](https://developers.samsara.com/reference/getsafetyeventsv2stream.md): This endpoint will return all safety events associated with your organization based on the parameters passed in. To get core endpoint data, select Read Safety Events & Scores under the Safety & Cameras category when creating or editing an API token. Read Camera Media permissions required to get Safety Event video media via this endpoint. If you include an endTime, the endpoint will return data up until that point. If you do not include an endTime, you can continue to poll the API real-time with the pagination cursor that gets returned on every call. Results are paginated. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Safety Events & Scores** under the Safety & Cameras category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Fetch driver safety score](https://developers.samsara.com/reference/v1getdriversafetyscore.md): This endpoint is still on our legacy API. Fetch the safety score for the driver. Rate limit: 5 requests/sec (learn more about rate limits here). **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Safety Events & Scores** under the Safety & Cameras category when creating or editing an API token. Learn More. - [[legacy] Fetch harsh events](https://developers.samsara.com/reference/v1getvehicleharshevent.md): **Note: This is a legacy endpoint, consider using [this endpoint](https://developers.samsara.com/reference/getsafetyeventsv2stream) instead. The endpoint will continue to function as documented.** This endpoint is still on our legacy API. Fetch harsh event details for a vehicle. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Safety Events & Scores** under the Safety & Cameras category when creating or editing an API token. Learn More. - [Fetch vehicle safety scores](https://developers.samsara.com/reference/v1getvehiclesafetyscore.md): This endpoint is still on our legacy API. Fetch the safety score for the vehicle. Rate limit: 5 requests/sec (learn more about rate limits here). **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Safety Events & Scores** under the Safety & Cameras category when creating or editing an API token. Learn More. - [Get driver scores](https://developers.samsara.com/reference/getdriversafetyscores.md): Get safety scores and overall risk factors for drivers. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Read Safety Events & Scores** under the Safety & Cameras category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get tags combined score](https://developers.samsara.com/reference/gettaggroupsafetyscores.md): Get a combined safety score and risk factors for a set of tags. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Read Safety Events & Scores** under the Safety & Cameras category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get tag scores](https://developers.samsara.com/reference/gettagsafetyscores.md): Get safety scores and overall risk factors for tags. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Read Safety Events & Scores** under the Safety & Cameras category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get vehicle scores](https://developers.samsara.com/reference/getvehiclesafetyscores.md): Get safety scores and overall risk factors for vehicles. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Read Safety Events & Scores** under the Safety & Cameras category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get Speeding Intervals](https://developers.samsara.com/reference/getspeedingintervals.md): This endpoint will return all speeding intervals associated with all trips that have been collected for your organization based on the time parameters passed in. Only completed trips are included. Trips with no speeding intervals detected will be returned with an empty list of intervals. Results are paginated. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Speeding Intervals** under the Speeding Intervals category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Delete training assignments.](https://developers.samsara.com/reference/deletetrainingassignments.md): This endpoint supports batch deletion operations. The response does not indicate which specific deletions, if any, have failed. On a successful deletion or partial failure, a ‘204 No Content’ status is returned. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Write Training Assignments** under the Training Assignments category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get a stream of filtered training assignments.](https://developers.samsara.com/reference/gettrainingassignmentsstream.md): Returns all training assignments data that has been created or modified for your organization based on the time parameters passed in. Results are paginated and are sorted by last modified date. If you include an endTime, the endpoint will return data up until that point (exclusive). If you don't include an endTime, the API will continue to poll with the pagination cursor that gets returned on every call. The hasNextPage response value will be true if there is no endTime specified and endCursor is nonempty. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Training Assignments** under the Training Assignments category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Update training assignments.](https://developers.samsara.com/reference/patchtrainingassignments.md): Update training assignments. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Write Training Assignments** under the Training Assignments category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create training assignments.](https://developers.samsara.com/reference/posttrainingassignments.md): Create training assignments. Existing assignments will remain unchanged. Rate limit: 10 requests/sec (learn more about rate limits here). To use this endpoint, select **Write Training Assignments** under the Training Assignments category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create a single issue.](https://developers.samsara.com/reference/postissue.md): Creates a new issue associated with an asset, with optional media attachments uploaded inline as base64. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Issues** under the Forms category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Overview](https://developers.samsara.com/reference/overview.md) - [Create an assignment](https://developers.samsara.com/reference/createcarrierproposedassignment.md): Creates a new assignment that a driver can later use. Each driver can only have one future assignment. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Carrier-Proposed Assignments** under the Assignments category when creating or editing an API token. Learn More. - [Delete an assignment](https://developers.samsara.com/reference/deletecarrierproposedassignment.md): Permanently delete an assignment. You can only delete assignments that are not yet active. To override a currently active assignment, create a new empty one, instead. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Carrier-Proposed Assignments** under the Assignments category when creating or editing an API token. Learn More. - [Retrieve assignments](https://developers.samsara.com/reference/listcarrierproposedassignments.md): Show the assignments created by the POST fleet/carrier-proposed-assignments. This endpoint will only show the assignments that are active for drivers and currently visible to them in the driver app. Once a proposed assignment has been accepted, the endpoint will not return any data. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Carrier-Proposed Assignments** under the Assignments category when creating or editing an API token. Learn More. - [Delete document](https://developers.samsara.com/reference/deletedocument.md): Deletes a single document. The legacy version of this endpoint can be found at [samsara.com/api-legacy](https://www.samsara.com/api-legacy#operation/deleteDriverDocumentByIdAndDriverId). Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Documents** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create a document PDF](https://developers.samsara.com/reference/generatedocumentpdf.md): Request creation of a document PDF. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Write Documents** under the Driver Workflow category when creating or editing an API token. Learn More. - [Fetch document](https://developers.samsara.com/reference/getdocument.md): Returns a single document. The legacy version of this endpoint can be found at [samsara.com/api-legacy](https://www.samsara.com/api-legacy#operation/getDriverDocumentByIdAndDriverId). Rate limit: 25 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Documents** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Query a document PDF](https://developers.samsara.com/reference/getdocumentpdf.md): Returns generation job status and download URL for a PDF. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. To use this endpoint, select **Read Documents** under the Driver Workflow category when creating or editing an API token. Learn More. - [Fetch all documents](https://developers.samsara.com/reference/getdocuments.md): Get all documents for the given time range. The legacy version of this endpoint can be found at [samsara.com/api-legacy](https://www.samsara.com/api-legacy#operation/getDriverDocumentsByOrgId). Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Documents** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Fetch document types](https://developers.samsara.com/reference/getdocumenttypes.md): Returns a list of the organization document types. The legacy version of this endpoint can be found at [samsara.com/api-legacy](https://www.samsara.com/api-legacy#operation/getDriverDocumentTypesByOrgId). Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Documents** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create document](https://developers.samsara.com/reference/postdocument.md): Creates a single document. The legacy version of this endpoint can be found at [samsara.com/api-legacy](https://www.samsara.com/api-legacy#operation/createDriverDocument). Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Documents** under the Driver Workflow category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get a list of specified form submissions.](https://developers.samsara.com/reference/getformsubmissions.md): Returns all form submissions data for the specified list of IDs. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Form Submissions** under the Forms category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Return a PDF export that has already been generated for a form submission.](https://developers.samsara.com/reference/getformsubmissionspdfexports.md): Returns a PDF export that has already been generated for a form submission. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Read Form Submissions** under the Forms category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get a stream of filtered form submissions.](https://developers.samsara.com/reference/getformsubmissionsstream.md): Returns all form submissions data that has been created or modified for your organization based on the time parameters passed in. Results are paginated and are sorted by last modified date. If you include an endTime, the endpoint will return data up until that point (exclusive). If you don’t include an endTime, you can continue to poll the API real-time with the pagination cursor that gets returned on every call. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Form Submissions** under the Forms category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get a list of form templates.](https://developers.samsara.com/reference/getformtemplates.md): Returns a list of the organization's form templates for the specified list of IDs. If no IDs are provided, all form templates for the organization will be returned. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Form Submissions** under the Forms category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Update a single form submission.](https://developers.samsara.com/reference/patchformsubmission.md): Updates an instance of a form submission. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Form Submissions** under the Forms category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create a form submission.](https://developers.samsara.com/reference/postformsubmission.md): Creates a form submission and assigns it to an individual worker. This endpoint can be used to create an empty or partially complete form submission and assign it to a worker. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Form Submissions** under the Forms category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Create a PDF export for an existing form submission.](https://developers.samsara.com/reference/postformsubmissionspdfexports.md): Creates a PDF export for an existing form submission. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Form Submissions** under the Forms category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get a list of specified issues.](https://developers.samsara.com/reference/getissues.md): Returns all issues data for the specified IDs. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Issues** under the Forms category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Get a stream of filtered issues.](https://developers.samsara.com/reference/getissuesstream.md): Returns all issues data that has been created or modified for your organization based on the time parameters passed in. Results are paginated and are sorted by last modified date. If you include an endTime, the endpoint will return data up until that point (exclusive). If you don’t include an endTime, you can continue to poll the API real-time with the pagination cursor that gets returned on every call. Rate limit: 5 requests/sec (learn more about rate limits here). To use this endpoint, select **Read Issues** under the Forms category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. - [Update a single issue.](https://developers.samsara.com/reference/patchissue.md): Updates an instance of an issue. Rate limit: 100 requests/min (learn more about rate limits here). To use this endpoint, select **Write Issues** under the Forms category when creating or editing an API token. Learn More. **Submit Feedback**: Likes, dislikes, and API feature requests should be filed as feedback in our API feedback form. If you encountered an issue or noticed inaccuracies in the API documentation, please submit a case to our support team. ## Recipes - [Creating a route](https://developers.samsara.com/recipes/creating-a-route.md) - [Custom Duty Status Report](https://developers.samsara.com/recipes/custom-duty-status-report.md) - [Data Replication (Database/CSV)](https://developers.samsara.com/recipes/data-replication-databasecsv.md) - [Export Route Status Report](https://developers.samsara.com/recipes/export-route-status-report.md) - [HOS Exemption Report](https://developers.samsara.com/recipes/hos-exemption-report.md) - [OAuth 2.0](https://developers.samsara.com/recipes/oauth-20.md) - [Trip Export Report](https://developers.samsara.com/recipes/trip-export-report.md) - [Write Live Telematics Data to a CSV File](https://developers.samsara.com/recipes/write-live-telematics-data-to-a-csv-file.md) - [Write VG Install Statuses to CSV File](https://developers.samsara.com/recipes/write-vg-install-statuses-to-csv-file.md) ## Changelog - [New Preview API: POST preview/fleet/tachograph/file-uploads](https://developers.samsara.com/changelog/new-preview-api-post-previewfleettachographfile-uploads.md) - [New Beta API: POST gateways/pair](https://developers.samsara.com/changelog/new-beta-api-post-gatewayspair-1.md) - [New Beta API: POST gateways/pair](https://developers.samsara.com/changelog/new-beta-api-post-gatewayspair.md) - [New Beta API: GET maintenance/preventive/upcoming](https://developers.samsara.com/changelog/new-beta-api-get-maintenancepreventiveupcoming-1.md) - [New Beta API: GET maintenance/preventive/upcoming](https://developers.samsara.com/changelog/new-beta-api-get-maintenancepreventiveupcoming.md)