Learn everything about the asset endpoints and how you can use them
This overview highlights the functions of the asset endpoints and how it is useful for optimising the asset management and allowing you to gain important insights into your operations.
List all the company assets
- Endpoint: v1/assets
- Description: Retrieves a comprehensive list of all the assets that are currently associated with your organisation.
- Use Case: Quickly view and assess the number of assets that are currently active for your organisation. This allows you to ensure your fleet is operating efficiently, when you have a full picture of your assets that are currently operational.
Lookup an asset using an external ID
- Endpoint: v1/assets/lookup_by_external_id
- Description: Fetch the details of a specific asset using an external identifier.
- Use Case: This endpoint is useful for organisations who prefer to use their own identifiers for the assets. Use the external identifier that is linked with an integration to lookup the details of that specific asset. At Motive, the external identifier is always associated with an integration. This is done to create a seamless link between the external identifier and the associated software using that identifier.
Create a new asset
- Endpoint: v1/assets
- Description: Allows you to add a new asset to the organisation's inventory.
- Use Case: Add a new asset to your growing fleet with this endpoint. You will be required to add as many details of the asset as possible. These parameters allow you to track and integrate the assets in to Motive's ecosystem.
Update an existing asset
- Endpoint:v1/assets/{id}
- Description: Lookup an existing asset with its ID, and then update the information for the same.
- Use Case: Fleets usually make changes to their assets such as status, locations, driver, and others. This endpoint easily allows you to make such operational updates to your assets by simply looking up the asset with its ID.
Fetch the activity report of a reefer
- Endpoint: v1/reefer_activity_reports
- Description: View the activities of a reefer through this report.
- Use Case: Reefers are as critical to fleet management companies as much as they are to the goods they carry. Timely monitoring of the temperatures, viewing of logs, and other performance metrics are what can be achieved with this endpoint. The activity report pulls out all the important data such as location, ambient temperature, fuel level, voltage, and others. This information is crucial in delivering the goods in the best of their condition.