LogoLogo
DocsHomeSupportContact
  • Getting Started
    • Introduction
    • Build on DIMO
  • DEVELOPER GUIDE
    • Developer Overview
    • Developer Console
    • Authentication
    • DIMO Developer SDKs
      • Data SDK
      • Login with DIMO SDK
        • React Component
        • Login with DIMO Redirect
        • Core Functionalities
      • TypeScript: Transactions SDK
      • SDK Release Notes
    • Low Code Tools
      • n8n: Getting Started
    • Permissions Contract: SACD
    • DIMO Credits
    • Response Types
    • Rate Limits
    • Developer FAQ
    • Developer Changelogs
    • Troubleshooting Common Issues
  • API References
    • Overview of DIMO API
    • Attestation API
    • Device Definitions API
    • Identity API
      • Schema & Types
      • Scalars
      • Nodes & Objects
        • AftermarketDevice
        • AftermarketDeviceConnection
        • DCN
        • DCNConnection
        • DeveloperLicense
        • DeviceDefinition
        • Earning
        • EarningsConnection
        • Manufacturer
        • Sacd
        • SyntheticDevice
        • Vehicle
        • VehicleConnection
        • VehicleEarnings
        • UserRewards
      • Common Queries
    • Telemetry API
      • Schema & Types
      • Scalars
      • Nodes & Objects
        • Signals
        • SignalsLatest
      • Common Queries
    • Token Exchange API
    • Trips API
    • Valuations API
  • DIMO Hardware
    • Introduction
    • DIMO Hardware Application
    • DIMO Manufacturing License
    • Development & Certification
    • Audits & Assessments
      • Hardware & Security Audit
      • Customer Experience Assessment
      • Integration Testing & Quality Control
      • Final Approval
    • DIMO Device License
      • Device Minting Certificates
    • Essential Documents
      • Hardware & Security Audit Checklist
      • Approved Hardware Auditors
      • DIMO Memorandum of Understanding (MOU)
  • Additional References
    • Developer License
    • DIMO GraphQL Basics
  • Deprecated Resources
    • Guides
      • Developer Journey
      • Quick Start Guide
      • Hello World
      • Code Exchange Flow
    • Data Availability
Powered by GitBook
On this page
  • Base URLs
  • Getting a Trips History
  • List Vehicle Trips by Vehicle Token ID
  • Entity Types
  • Trips

Was this helpful?

  1. API References

Trips API

PreviousToken Exchange APINextValuations API

Last updated 1 month ago

Was this helpful?

Base URLs

https://trips-api.dimo.zone


Developer Notes

To access the Trips API, a token exchange transaction is required to obtain a 2nd JWT to get permission to access the vehicle's trip. Please check Token Exchange API prior to using this endpoint.

Getting a Trips History

List Vehicle Trips by Vehicle Token ID

GET /v1/vehicle/{tokenId}/trips

Retrieves a list of trips taken by the Vehicle identified with the provided Vehicle ID.

Path Parameters

Name
Type
Description

tokenId*

String

Vehicle token ID, this is the token ID of your vehicle NFT. A prerequisite is to obtain a token that is permitted to access trips data for this specific vehicle.

Headers

Name
Type
Description

Authorization*

String

{
    "trips": [
        {
            "id": "2hyZ4PrT9NNTLJXXRufpPFUPUxn",
            "start": {
                "time": "2024-06-16T20:01:25.397535Z",
                "location": {
                    "latitude": 36.157856,
                    "longitude": -115.334557
                },
                "estimatedLocation": {
                    "latitude": 36.15789,
                    "longitude": -115.334572
                }
            },
            "end": {
                "time": "2024-06-16T20:08:55.426886Z",
                "location": {
                    "latitude": 36.189941,
                    "longitude": -115.35775
                }
            },
            "droppedData": false
        }
    ],
    "totalPages": 5,
    "currentPage": 1
}
{
    "code": 401,
    "message": "Invalid JWT."
}

Get Trips: Data SDK Function Calls

await dimo.trips.list({
    vehicleJwt, 
    tokenId
});
dimo.trips.trips(vehicle_jwt, token_id)
await dimoClient.TripsService.ListTripsByTokenIdAsync(
    authToken,
    tokenId
);

Entity Types

Trips

Trips are defined as the journeys between two waypoints. The trip entity stores the start time and the end time of each journey.

Vehicle JWT in .

{baseUrl}
Bearer Authentication format