Users API Endpoints
Last updated
Last updated
https://users-api.dimo.zone
GET
{baseUrl}
/v1/user
Retrieves user attributes for the authenticated user.
Name | Type | Description |
---|---|---|
PUT
{baseUrl}
/v1/user
Updates/modifies attributes for the authenticated user.
DELETE
{baseUrl}/v1/user
Deletes the authenticated user. Throws a 409 error if the authenticated user has device registered.
POST
{baseUrl}
/v1/user/send-confirmation-email
Sends a confirmation email to the registered email address of the authenticated user. This is the initiation step of the 2-factor authentication (2FA).
POST
{baseUrl}
/v1/user/confirm-email
Confirms the receipt of the confirmation email, this is the completion step of the 2-factor authentication (2FA).
POST
{baseUrl}
/v1/user/web3/challenge/generate
Generates a Web3 challenge message with an expiration timestamp for the user to sign.
POST
{baseUrl}
/v1/user/web3/challenge/submit
Confirms ownership of an Ethereum address.
GET
{baseUrl}/v1/user/check-accounts
Retrieves other connected accounts of the authenticated user.
POST
{baseUrl}
/v1/user/agree-tos
Sends a confirmation agreeing to the current Terms of Service.
POST
{baseUrl}
/v1/user/submit-referral-code
Submits a referral code from another user. The request sends the referral code, validates, and stores it for referral rewards recognition.
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Name | Type | Description |
---|---|---|
Authorization*
String
Bearer authentication using the access_token
generated from the Web3 challenge.
Authorization*
String
Bearer authentication using the access_token
generated from the Web3 challenge.
userUpdateRequest*
Object
See example below for data structure:
Authorization*
String
Bearer authentication using the access_token
generated from the Web3 challenge.
Authorization*
String
Bearer authentication using the access_token
generated from the Web3 challenge.
Authorization*
String
Bearer authentication using the access_token
generated from the Web3 challenge.
confirmEmailRequest*
Object
Specifies the key from the email. This needs to be in the format of { "key": "<6-digit-number>" }
Authorization*
String
Bearer authentication using the access_token
generated from the Web3 challenge.
Authorization*
String
Bearer authentication using the access_token
generated from the Web3 challenge.
confirmEthereumRequest*
Object
This needs to be in the format of { "signature": "<signed_challenge_msg>" }
Authorization*
String
Bearer authentication using the access_token
generated from the Web3 challenge.
Authorization*
String
Bearer authentication using the access_token
generated from the Web3 challenge.
Authorization*
String
Bearer authentication using the access_token
generated from the Web3 challenge.
submitReferralCodeRequest*
Object
This needs to be in the format of { "referralCode": "<6-digit-code>" }