Trips API Endpoints

Base URLs

Dev

https://trips-api.dev.dimo.zone

Production

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 {baseUrl}/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	Bearer authentication using the token generated from the Token Exchange.

200: Success

{
    "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"
            }
        }
    ]
}

401: Unauthorized

{
    "code": 401,
    "message": "Invalid JWT."
}

---

Swagger Doc

Swagger UI