Attestation API

Base URLs

Production

https://attestation-api.dimo.zone

---

Create Verifiable Credentials (VC)

Create a Vehicle VIN VC

POST /v1/vc/vin/{tokenId}

Generates the VIN VC for a given vehicle if it has never been created, or if it has expired. If an unexpired VC is found, returns the VC.

After you've obtained the rawVC from the response, you can use it to perform queries on the Telemetry API, such as getting the VIN of a vehicle.

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	Vehicle JWT in Bearer Authentication format.

Response

200: Success

{
    "vcUrl": "https://telemetry-api.dimo.zone/query",
    "vcQuery": "query {vinVCLatest(tokenId: <TOKEN_ID>) {rawVC}}",
    "message": "VC generated successfully. Retrieve using the provided GQL URL and query parameter."
}

400: Invalid Request

{
  "error": "Invalid request"
}

Create VIN VC: Data SDK Function Calls

TypeScript

await dimo.attestation.createVinVC({
    vehicleJwt, 
    tokenId
});

Python

dimo.attestation.create_vin_vc(vehicle_jwt, token_id)

C#

await dimoClient.AttestationService.CreateVinVcAsync(
    vehicleJwt,
    tokenId
);