👉
Set up your account
Learn how to set up your account on Credential Service.
The user is required to Log In to the Credential Service and authenticate in order to access the APIs. This guards the API from unauthorized access and is required for both testing production environments.
Credential Service uses a third party service called LogTo to handle user authentication and login. This allows users to create new accounts as well as sign in using their email, Google single sign-on, or Discord login.

Sign into your account

Create a new account
The following API can be used to fetch the new account information:
customer_id
is used as an identifier for the particular customer using the Credential Service. It is generated as a sub-field of the JWT token used in the authorization header.cheqd_account
is used to pay for identity transactions on eithertestnet
ormainnet
. A cheqd account is automatically generated when a newcustomer_id
is generated.
get
/account
Fetch custodian-mode client details.
This endpoint returns the custodian-mode client details for authenticated users.
Parameters
No parameters
Responses
200: OK
The request was successful.
400: Bad Request
A problem with the input fields has occurred. Additional state information plus metadata may be available in the response body.
401: Unauthorized
Access token is missing or invalid
500: Internal Server Error
An internal error has occurred. Additional state information plus metadata may be available in the response body.
Users will need to add our token, CHEQ, to their
cheqd_account
on mainnet
in order to be able to use the ledger-based identity functionality on Credential Service, such as creating DIDs and DID-Linked Resources.If you need to add CHEQ tokens to your Credential Service
cheqd_account
, there are a few steps you need to follow:- First you need to setup your wallet which is able to hold CHEQ tokens. We recommend using Leap Wallet which natively supports all CHEQ transactions in a browser plugin or on mobile. Alternatively, follow the tutorial here to setup your Keplr wallet.
- You will need to send CHEQ tokens from your new cheqd Wallet account to your
cheqd_account
address for using the Credential Service.
- It is unlikely that you will ever need to top up your Testnet account, as this is handled automatically. However, in the event that your Testnet account runs out of tokens, you can follow the step below.
- This is super simple. You can add free CHEQ tokens to your cheqd_account via our Testnet Faucet by inputting your cheqd account address. Access the Testnet Faucet directly here.
Once you have successfully created an account and have topped up your CHEQ tokens, you are ready to get started!