Users

The authenticated principal behind the API key.

1 endpoint. Every request needs an Authorization: Bearer mtro_... header, and responses follow the envelope described in Errors and conventions.

GET /users/get

Get the currently authenticated user's profile information including name, email, role, and entity.

Required scope: any valid API key for the entity.
MCP tool: whoami

Example

curl -X GET 'https://core.mtro.app/users/get' \
  -H 'Authorization: Bearer mtro_your_api_key'

Response

Field	Type
message	string
error	boolean
user	object
entity	object
memberships	object[]
activeMembership	object
capabilities	object
featureAccess	object

Fields of user

Field	Type
id	string
email	string
name	string
surname	string
emailVerified	boolean
mobileVerified	boolean
type	string
emailNotificationsActive	boolean
smsNotificationsActive	boolean
whatsappNotificationsActive	boolean
preferences	object
blockchainAddress	string
profileImage	string
twoFactor	object
entityRole	string
propertyAccess	string
allowedPropertyIds	any[]
passwordChanged	boolean
onboardingCompleted	boolean
onboardingProgress	object