Token Exchange Endpoints

DIMO Check-in

Usage of this API endpoint can be done via Developer SDKs.

Base URLs

https://token-exchange-api.dimo.zone

Privilege Definitions

Privilege	Description
1	All-time, non-location data
2	Commands
3	Current location
4	All-time location
5	Verifiable Credentials
6	Streams

Exchanging for a Vehicle JWT 🔐

Create a Token Exchange

POST {baseUrl}/v1/tokens/exchange

Creates a token exchange to obtain a Vehicle JWT. The response will provide a short-lived token that last you 10 minutes to access additional vehicle information such as Trips and Telemetry data

Headers

Name Type Description

Name	Type	Description
`Authorization`*	String	Developer JWT in Bearer Authentication format.

Authorization*

String

Developer JWT in Bearer Authentication format.

Request Body

Name Type Description

Name	Type	Description
`nftContractAddress`*	String	The Vehicle NFT address, in the Production environment, this is `0xbA5738a18d83D41847dfFbDC6101d37C69c9B0cF`.
`privileges`*	[Integer]	An array of integers indicating the level of privileges provided to the token bearer. Refer to this section for privileges definitions.
`tokenId`*	Integer	The Vehicle ID that you are requesting permission to. This is an integer that indicates the vehicle you are inquiring about.

nftContractAddress*

String

The Vehicle NFT address, in the Production environment, this is 0xbA5738a18d83D41847dfFbDC6101d37C69c9B0cF.

privileges*

[Integer]

An array of integers indicating the level of privileges provided to the token bearer.

Refer to this section for privileges definitions.

tokenId*

Integer

The Vehicle ID that you are requesting permission to. This is an integer that indicates the vehicle you are inquiring about.

{
    "token": "eyJhbGciOiJSUzI1NiIsImtpZCI6IjJmMGM3NTc5ZmYyYTAzMGY0NmY1YzVkMzMyY2YyYjMyMzkxMzIxZGIifQ.eyJjb250cmFjdF9hZGRyZXNzIjoiMHhiYTU3MzhhMThkODNkNDE4NDdkZmZiZGM2MTAxZDM3YzY5YzliMGNmIiwiZXhwIjoxNzA2MDM4MTI4LCJpYXQiOjE3MDYwMzc1MjgsImlzcyI6Imh0dHBzOi8vYXV0aC1yb2xlcy1yaWdodHMuZGltby56b25lIiwicHJpdmlsZWdlX2lkcyI6WzRdLCJzdWIiOiIweGJBNTczOGExOGQ4M0Q0MTg0N2RmRmJEQzYxMDFkMzdDNjljOUIwY0YvMjE5NTciLCJ0b2tlbl9pZCI6IjIxOTU3In0.0J3HIsNeG5-JvMBcTwR8KHhTnXb31jvwjxiKVRnNaFidE0vLbyd6PtPsouniZQMIC46wzqwm2c7aZ61WhPIx9p5TB-cKcMmeKFE9mFZfBuSmvNbDd5icAvkxogWlNPki5WM2_otaGf9WtsZPlWW9GgUmBoPaRhiKB3fX7TPROcn0tTjtVir9HJKnf2CMkDwTk9rZxer8eGB6ekBSJr1aDjdqlY6HRxF_azy_rWVdzB1Wd1He9KyB3HHr1qBk5XK8d_zTA-4X3i3IEP5Z8Q3gxgoQRem70SnBNpjJjeRgAgzjfqHnKaFcjhKlxWD0h9mnpGWvd3oZLd9BPqR3WyDUCA"
}

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

{
    "code": 403,
    "message": "<some_error_message>"
}

Swagger Doc

PreviousToken Exchange API NextTrips API

Last updated 2 days ago