Events API Endpoints

Base URLs

Dev

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

Production

https://events-api.dimo.zone

---

API References

List All User Events

GET {baseUrl}/v1/events

Lists the user's events in reverse chronological order.

Query Parameters

Name	Type	Description
device_id	String	Filter by DIMO deviceId, this is relevant when the event relates to a device.
type	String	Filter by type, type can be either User or Device.
sub_type	String	Filter by subType of the event. - subType for User: Created, TokensIssued, and ReferralCompleted - subType for Device: Created, Minted, Deleted, IntegrationCreated, IntegrationDeleted, and OdometerUpdated.

Headers

Name	Type	Description
Authorization*	String	Bearer authentication using the access_token generated from the Web3 challenge.

401: Unauthorized Invalid or expired JWT.

200: OK Successfully retrieved a list of user events.

[
    {
        "id": "2b9GcoHZYKiwHZmZHBtFdxzy51v",
        "type": "User",
        "subType": "Created",
        "userId": "CioweGY5RDI2MzIzQWI0OTE3OUE2ZDU3QzI2NTE1QjAxRGUwMTg1NTM3ODcSBHdlYjM",
        "deviceId": null,
        "timestamp": "2024-01-18T23:19:22.694806Z",
        "data": {
            "method": "web3",
            "userId": "CioweGY5RDI2MzIzQWI0OTE3OUE2ZDU3QzI2NTE1QjAxRGUwMTg1NTM3ODcSBHdlYjM",
            "timestamp": "2024-01-18T23:19:22.694805687Z"
        }
    }
]

---

Swagger Doc

Swagger UI