Account APIs

The Account APIs handle user registration, authentication, session management, and account queries within the Guardian system.

Base URL: /api/v1/accounts

Note: POST /accounts/register, POST /accounts/login, and POST /accounts/access-token do not require a Bearer token. All other endpoints require Authorization: Bearer <token>.

---

Endpoints

Method	Endpoint	Description	Auth Required
POST	/accounts/register	Register a new user account	No
POST	/accounts/login	Log in and receive JWT tokens	No
POST	/accounts/change-password	Change the authenticated user's password	Yes
POST	/accounts/access-token	Refresh access token using a refresh token	No
GET	/accounts/session	Return current session information	Yes
GET	/accounts/	List users (excluding Standard Registry and Auditor)	Yes
GET	/accounts/standard-registries	Return all Standard Registry accounts	Yes
GET	/accounts/standard-registries/aggregated	Return Standard Registries with policies and VCs	Yes
GET	/accounts/balance	Return the authenticated user's Hedera balance	Yes

---

Endpoint Details

• Registering a New Account

• User Login

• Change Password

• Refresh Access Token

• User Session

• User Listing (Excluding Standard Registry and Auditor)

• Returns All Standard Registries

• Standard Registries Aggregated

• User Balance