Current User

August 3, 2026 · View on GitHub

Use case

Returns the current authenticated dashboard operator and selected merchant context.

Authentication

Dashboard protected. Send Authorization: Bearer <jwt_token>. In sandbox, also send x-feature: decision-engine.

For local development, start with:

export BASE_URL=http://localhost:8080
export AUTH_HEADER="Authorization: Bearer <jwt_token>"
# Sandbox only:
# export BASE_URL=https://sandbox.hyperswitch.io
# export FEATURE_HEADER="x-feature: decision-engine"

Request

Method and path: GET /auth/me
Parameters: none.
Body: No parameters or request body.

Example

Current user

curl "$BASE_URL/auth/me" \
  --header "$AUTH_HEADER"

Response

{
  "user_id": "user_123",
  "email": "operator@example.com",
  "merchant_id": "merchant_demo",
  "role": "admin",
  "email_verified": true,
  "merchants": [
    {
      "merchant_id": "merchant_demo",
      "merchant_name": "Demo Merchant",
      "role": "admin"
    }
  ]
}

Notes

Use this after refresh to restore the authenticated dashboard state.
A 401 means the dashboard should return to login.