Trips API Endpoints

Base URLs

https://trips-api.dev.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 {baseUrl}/v1/vehicle/{tokenId}/trips

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

Path Parameters

NameTypeDescription

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

NameTypeDescription

Authorization*

String

{
    "trips": [
        {
            "id": "2bKw1IiOAlIyjGZF1hn4TLMtvP3",
            "start": {
                "time": "2024-01-23T02:27:41.864317Z"
            },
            "end": {
                "time": "2024-01-23T03:03:24.186139Z"
            }
        },
        {
            "id": "2b9oJS9fJpKcZzdL1cd5UDRNOsZ",
            "start": {
                "time": "2024-01-19T03:56:23.976194Z"
            },
            "end": {
                "time": "2024-01-19T04:24:53.952568Z"
            }
        },
        {
            "id": "2b5wMjfG4yUu69C1WGZVEdEKT0e",
            "start": {
                "time": "2024-01-17T19:03:21.973294Z"
            },
            "end": {
                "time": "2024-01-17T19:11:21.934826Z"
            }
        },
        {
            "id": "2b5ro2cI4pcZmoQPDwTnCKxqaMk",
            "start": {
                "time": "2024-01-17T18:25:51.996063Z"
            },
            "end": {
                "time": "2024-01-17T18:35:22.038733Z"
            }
        },
        {
            "id": "2ayGMjZu1uEKAWbewxILmhB0kYc",
            "start": {
                "time": "2024-01-15T01:49:18.664539Z"
            },
            "end": {
                "time": "2024-01-15T01:55:48.691258Z"
            }
        },
        {
            "id": "2ayEQ2I4bPKcc45e67YnXOIuNQ3",
            "start": {
                "time": "2024-01-15T01:33:18.713955Z"
            },
            "end": {
                "time": "2024-01-15T01:38:48.79033Z"
            }
        }
    ]
}

Swagger Doc

Last updated