List User Merchants

August 3, 2026 · View on GitHub

Use case

Lists merchant workspaces available to the authenticated dashboard operator.

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/merchants
Parameters: none.
Body: No parameters or request body.

Example

List merchants

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

Response

[
  {
    "merchant_id": "merchant_demo",
    "merchant_name": "Demo Merchant",
    "role": "admin"
  },
  {
    "merchant_id": "merchant_sbx",
    "merchant_name": "Sandbox Merchant",
    "role": "member"
  }
]

Notes

Use this to populate the dashboard merchant switcher.
The active merchant is still controlled by the auth token/session context.