For AI agents: a documentation index is available at /llms.txt. A markdown version of this page is available at the same URL with .md appended (or via Accept: text/markdown).
Skip to main content

Get user info

The getUserInfo method returns a Web3AuthUserInfo object with details about the user, including sign-in type, whether multi-factor authentication (MFA) is enabled, profile image, and name.

This method throws Web3AuthError.noUserFound if no user session exists.

Usage​

let web3AuthUserInfo = try web3Auth.getUserInfo()

Get user info with the identity token​

getUserInfo returns the user info stored in the current session, where idToken can be nil. Use the async getUserInfoAsync method to fill in idToken from the session token storage when it's missing.

let web3AuthUserInfo = try await web3Auth.getUserInfoAsync()
note

For users who signed in with an idToken (single-factor authentication), idToken is always nil. SFA sign-in doesn't create session tokens, so getUserInfoAsync can't fill it in.

Example response​

{
"email": "w3a-heroes@web3auth.com",
"name": "Web3Auth Heroes",
"profileImage": "https://lh3.googleusercontent.com/a/Ajjjsdsmdjmnm...",
"authConnectionId": "torus",
"userId": "w3a-heroes@web3auth.com",
"authConnection": "google",
"groupedAuthConnectionId": "w3a-google-sapphire",
"dappShare": "", // 24 words of seed phrase will be sent only incase of custom auth connections
"idToken": "<jwtToken issued by Web3Auth>",
"oAuthIdToken": "<jwtToken issued by OAuth Provider>", // will be sent only incase of custom auth connections
"oAuthAccessToken": "<accessToken issued by OAuth Provider>", // will be sent only incase of custom auth connections
"isMfaEnabled": false, // Returns whether the user has enabled MFA or not
"appState": null // The appState passed in LoginParams, if any
}