This POST endpoint allows querying a user by email, id, or referenceId. Use only one field per request. If multiple fields are provided, the priority is email, followed by referenceId, and then id.
A successful response includes the user details and their wallets. Each wallet has a public address and a custody type, which can be custodial or non-custodial, depending on user control.
An optional ID of the reference object in your database. This can be used to query events by reference object.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Mufi","colors":{"primary":"#b7ff02","light":"#b7ff02","dark":"#080408"},"logo":{"light":"https://mintcdn.com/mufi-c3b4e9a4/9yxXrvWpIAZr8_21/logo/mufi-logo-white.svg?fit=max\u0026auto=format\u0026n=9yxXrvWpIAZr8_21\u0026q=85\u0026s=77e9b71ad2759fee018192b0eea1f87f","dark":"https://mintcdn.com/mufi-c3b4e9a4/9yxXrvWpIAZr8_21/logo/mufi-logo-white.svg?fit=max\u0026auto=format\u0026n=9yxXrvWpIAZr8_21\u0026q=85\u0026s=77e9b71ad2759fee018192b0eea1f87f"},"favicon":"/favicon.svg","appearance":{"default":"dark","strict":true},"background":{"decoration":"gradient","color":{"light":"#080408","dark":"#080408"}},"navbar":{"primary":{"type":"button","label":"Get Started","href":"https://my.mufi.app"}},"footer":{"socials":{"website":"https://mufi.app","twitter":"https://x.com/MusicFinance","discord":"https://discord.gg/SASbjT3B","telegram":"https://t.me/mufi_wallet","github":"https://github.com/mufitech","linkedin":"https://www.linkedin.com/company/mufi"}},"search":{"prompt":"Search..."},"fonts":{"heading":{"family":"Space Grotesk"},"body":{"family":"Plus Jakarta Sans"}},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"mufi-c3b4e9a4","hasAudioNarration":false,"actualSubdomain":"mufi-c3b4e9a4","customDomains":["docs.mufi.app"],"gitSource":{"type":"github","owner":"mufitech","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{},"buildId":"6ae92203142dc7511ce6f6f9:success","clientVersion":"0.0.4117","searchFilterCounts":[{"language":"default","tag":"Overview","count":11},{"language":"default","tag":"Users","count":9},{"language":"default","tag":"Products","count":8},{"language":"default","tag":"Events","count":8},{"language":"default","tag":"Products Endpoints","count":7},{"language":"default","tag":"Events Endpoints","count":7},{"language":"default","tag":"Users Endpoints","count":7},{"language":"default","tag":"Getting Started","count":6},{"language":"default","tag":"Security \u0026 Infrastructure","count":4},{"language":"default","tag":"Platform","count":3}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[],"page":{"pagePath":"docs/endpoint/wallets/fetch-user","slug":"/docs/endpoint/wallets/fetch-user","pageMetadata":{"openapi":"post /v1/users/profile","title":"Fetch User","description":"Retrieve detailed information about a user, including their associated wallets, by querying with `email`, `id`, or `referenceId`.","href":"/docs/endpoint/wallets/fetch-user","hidden":false},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx, jsxs: _jsxs} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n code: \"code\",\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsxs(_components.p, {\n children: [\"Retrieve detailed information about a user, including their associated wallets, by querying with \", _jsx(_components.code, {\n children: \"email\"\n }), \", \", _jsx(_components.code, {\n children: \"id\"\n }), \", or \", _jsx(_components.code, {\n children: \"referenceId\"\n }), \".\"]\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"openapi":"post /v1/users/profile","title":"Fetch User","description":"Retrieve detailed information about a user, including their associated wallets, by querying with `email`, `id`, or `referenceId`.","href":"/docs/endpoint/wallets/fetch-user","hidden":false}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"security":["72b9c45d-fda6-4074-9dbf-90d1fb5ff506"],"description":"Retrieve detailed information about a user, including their associated wallets, by querying with `email`, `id`, or `referenceId`.","summary":"Fetch User","tags":["wallets"],"requestBody":"a9ca6fc1-e6ec-4c8e-ac3d-a24e6ccdbed3","responses":{"200":"4d7ba113-3be6-4bd6-bf96-7eb6516901b4","400":"cf1bd5d5-f152-48f5-a28c-548a01eba568","401":"3cd1bc7c-4c57-44a7-898e-a776edf59fd8","403":"3e181a2a-61c7-49fc-a0e3-f6a0ee44de9d","404":"7912dea9-5ef0-4bd4-a334-a7bcdcc9def5"},"method":"post","type":"path","servers":["3ad9b19a-76c0-4dbc-9394-6cf1e13d06d9"],"path":"/v1/users/profile","baseUrlOptions":["https://dev.api.mufi.app/"],"title":"Fetch User","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"description":"This `POST` endpoint allows querying a user by `email`, `id`, or `referenceId`. Use only one field per request. If multiple fields are provided, the priority is `email`, followed by `referenceId`, and then `id`.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","uniqueKey":"id","typeLabel":"string\u003cuuid>"},"email":{"type":"string","format":"email","uniqueKey":"email","typeLabel":"string\u003cemail>"},"referenceId":{"type":"string","uniqueKey":"referenceId","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","email":"jsmith@example.com","referenceId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"4d7ba113-3be6-4bd6-bf96-7eb6516901b4":{"description":"A successful response includes the user details and their wallets. Each wallet has a public address and a custody type, which can be `custodial` or `non-custodial`, depending on user control.","content":{"application/json":{"schema":{"type":"object","properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"id","typeLabel":"string\u003cuuid>"},"isActivated":{"type":"boolean","isRequired":true,"uniqueKey":"isActivated","typeLabel":"boolean"},"activatedOn":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"activatedOn.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"activatedOn.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"activatedOn","typeLabel":"string\u003cdate-time> | null"},"wallets":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","isRequired":true,"uniqueKey":"wallets.items.[INDEX].id","typeLabel":"string"},"type":{"type":"string","enum":["Polkadot"],"isRequired":true,"uniqueKey":"wallets.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"address":{"type":"string","isRequired":true,"uniqueKey":"wallets.items.[INDEX].address","typeLabel":"string"},"custody":{"type":"string","enum":["user-controlled","custodial"],"isRequired":true,"uniqueKey":"wallets.items.[INDEX].custody","typeLabel":"enum\u003cstring>"}},"required":["id","type","address","custody"],"uniqueKey":"wallets.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"wallets","typeLabel":"object[]"},"firstName":{"oneOf":[{"type":"string","uniqueKey":"firstName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"firstName.oneOf.1","typeLabel":"null"}],"uniqueKey":"firstName","typeLabel":"string | null"},"lastName":{"oneOf":[{"type":"string","uniqueKey":"lastName.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"lastName.oneOf.1","typeLabel":"null"}],"uniqueKey":"lastName","typeLabel":"string | null"},"email":{"type":"string","format":"email","uniqueKey":"email","typeLabel":"string\u003cemail>"},"referenceId":{"oneOf":[{"type":"string","description":"An optional ID of the reference object in your database. This can be used to query events by reference object.","uniqueKey":"referenceId.oneOf.0","typeLabel":"string"},{"type":"null","description":"An optional ID of the reference object in your database. This can be used to query events by reference object.","uniqueKey":"referenceId.oneOf.1","typeLabel":"null"}],"uniqueKey":"referenceId","typeLabel":"string | null"}},"required":["id","isActivated","activatedOn","wallets"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","isActivated":true,"activatedOn":"2023-11-07T05:31:56Z","wallets":[{"id":"\u003cstring>","type":"Polkadot","address":"\u003cstring>","custody":"user-controlled"}],"firstName":"\u003cstring>","lastName":"\u003cstring>","email":"jsmith@example.com","referenceId":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"cf1bd5d5-f152-48f5-a28c-548a01eba568":{"description":"A bad request will contain a list of errors for invalid fields.","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"string","uniqueKey":"errors.items.[INDEX]","typeLabel":"string"},"isRequired":true,"uniqueKey":"errors","typeLabel":"string[]"}},"required":["errors"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"errors":["\u003cstring>"]}}},"exampleType":"generated"}},"exampleType":"generated"},"3cd1bc7c-4c57-44a7-898e-a776edf59fd8":{"description":"Unauthorized. The API key is missing or has expired if you are using a key with an expiration date that you configured when creating the key.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"3e181a2a-61c7-49fc-a0e3-f6a0ee44de9d":{"description":"Forbidden. The API key that you provided is not valid or does not exist.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"},"7912dea9-5ef0-4bd4-a334-a7bcdcc9def5":{"description":"User not found.","content":{"application/json":{"schema":{"type":"object","properties":{"message":{"type":"string","isRequired":true,"uniqueKey":"message","typeLabel":"string"}},"required":["message"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"message":"\u003cstring>"}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"72b9c45d-fda6-4074-9dbf-90d1fb5ff506":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"A JWT Access Token obtained from Google Cloud.","scopes":[]}}},"servers":{"3ad9b19a-76c0-4dbc-9394-6cf1e13d06d9":{"url":"https://dev.api.mufi.app/","description":"Staging"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"A JWT Access Token obtained from Google Cloud.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A JWT Access Token obtained from Google Cloud.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi.yaml"},"subdomain":"mufi-c3b4e9a4","siteName":"Mufi","title":"Fetch User - Mufi","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"originalFileLocation":"docs/endpoint/wallets/fetch-user.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=\"dark\";if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"dark\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Retrieve detailed information about a user, including their associated wallets, by querying with email, id, or referenceId.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Mufi\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mufi-c3b4e9a4/jeKtxkWyBRrXgK-J/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/mufi-c3b4e9a4/jeKtxkWyBRrXgK-J/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mufi-c3b4e9a4/jeKtxkWyBRrXgK-J/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/mufi-c3b4e9a4/jeKtxkWyBRrXgK-J/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/mufi-c3b4e9a4/jeKtxkWyBRrXgK-J/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/mufi-c3b4e9a4/jeKtxkWyBRrXgK-J/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/mufi-c3b4e9a4/jeKtxkWyBRrXgK-J/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/mufi-c3b4e9a4/jeKtxkWyBRrXgK-J/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/mufi-c3b4e9a4/jeKtxkWyBRrXgK-J/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Fetch User - Mufi\">\u003cmeta data-mint-head property=\"og:description\" content=\"Retrieve detailed information about a user, including their associated wallets, by querying with email, id, or referenceId.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Mufi\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.mufi.app/docs/endpoint/wallets/fetch-user\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://mufi-c3b4e9a4.mintlify.site/_mintlify/api/og/v2?division=Users+Endpoints\u0026amp;title=Fetch+User\u0026amp;description=Retrieve+detailed+information+about+a+user%2C+including+their+associated+wallets%2C+by+querying+with+%60email%60%2C+%60id%60%2C+or+%60referenceId%60.\u0026amp;theme=04095e610e7737d5f621f813\u0026amp;signature=6a4c632d71624baec0f9e22108cd518daffc5aab05d84d876663bef3df598797\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Fetch User - Mufi\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Retrieve detailed information about a user, including their associated wallets, by querying with email, id, or referenceId.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://mufi-c3b4e9a4.mintlify.site/_mintlify/api/og/v2?division=Users+Endpoints\u0026amp;title=Fetch+User\u0026amp;description=Retrieve+detailed+information+about+a+user%2C+including+their+associated+wallets%2C+by+querying+with+%60email%60%2C+%60id%60%2C+or+%60referenceId%60.\u0026amp;theme=04095e610e7737d5f621f813\u0026amp;signature=6a4c632d71624baec0f9e22108cd518daffc5aab05d84d876663bef3df598797\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/mufi-c3b4e9a4/jeKtxkWyBRrXgK-J/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Mufi\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#b7ff02\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.mufi.app/docs/endpoint/wallets/fetch-user\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/docs/endpoint/wallets/fetch-user.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.mufi.app/#organization\",\"name\":\"Mufi\",\"url\":\"https://docs.mufi.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/mufi-c3b4e9a4/9yxXrvWpIAZr8_21/logo/mufi-logo-white.svg?fit=max\u0026auto=format\u0026n=9yxXrvWpIAZr8_21\u0026q=85\u0026s=77e9b71ad2759fee018192b0eea1f87f\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.mufi.app#website\",\"name\":\"Mufi\",\"url\":\"https://docs.mufi.app\",\"publisher\":{\"@id\":\"https://docs.mufi.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.mufi.app/docs/endpoint/wallets/fetch-user#webpage\",\"url\":\"https://docs.mufi.app/docs/endpoint/wallets/fetch-user\",\"name\":\"Fetch User\",\"description\":\"Retrieve detailed information about a user, including their associated wallets, by querying with email, id, or referenceId.\",\"isPartOf\":{\"@id\":\"https://docs.mufi.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.mufi.app/docs/endpoint/wallets/fetch-user#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.mufi.app/docs/endpoint/wallets/fetch-user#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Users Endpoints\",\"item\":\"https://docs.mufi.app/docs/endpoint/wallets/create-user\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Fetch User\",\"item\":\"https://docs.mufi.app/docs/endpoint/wallets/fetch-user\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.mufi.app/docs/endpoint/wallets/fetch-user#apireference\",\"headline\":\"Fetch User\",\"name\":\"Fetch User\",\"description\":\"Retrieve detailed information about a user, including their associated wallets, by querying with email, id, or referenceId.\",\"url\":\"https://docs.mufi.app/docs/endpoint/wallets/fetch-user\",\"mainEntityOfPage\":{\"@id\":\"https://docs.mufi.app/docs/endpoint/wallets/fetch-user#webpage\"},\"publisher\":{\"@id\":\"https://docs.mufi.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.mufi.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Mufi\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Mufi\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/docs/endpoint/wallets/fetch-user.md","siteName":"Mufi","nav":{"global":null,"tabs":[{"tab":"Overview","pages":[{"title":"Overview","href":"/docs/introduction"}]},{"tab":"Users","groups":[{"group":"Getting Started","pages":[{"title":"Introduction","href":"/docs/users/introduction"}]},{"group":"Users Endpoints","pages":[{"openapi":"post /v1/users/create","title":"Create User","description":"Users are created immediately and will have a blockchain wallet asynchronously created in the background.\n\nWallet generation involves securely splitting the private key into encrypted fragments using **[Shamir's Secret Sharing Scheme (SSSS)](https://en.wikipedia.org/wiki/Shamir%28s_secret_sharing)**. These fragments are then distributed across a fault-tolerant, distributed storage system across multiple platform providers with an additional layer of re-encryption to enhance security.\n\nFor large batches of users, the wallet creation process may take a few minutes to complete depending on the batch size and system load. Once complete, the users and their wallets are fully operational and available for blockchain transactions.\n\n## Key Features of the Process:\n\n**API Key Association**: Each user is linked to your organization's project application via the API key for secure access.\n\n**Asynchronous Processing**: User wallet creation occurs in the background to avoid delays in the user experience.\n\n**Enhanced Security**: Wallet secrets are created and split into encrypted fragments (SSSS) and stored in a distributed system with re-encryption.\n","href":"/docs/endpoint/wallets/create-user"},{"openapi":"post /v1/users/profile","title":"Fetch User","href":"/docs/endpoint/wallets/fetch-user"},{"openapi":"post /v1/users/fetch","title":"Fetch Users","description":"Retrieve users linked to your project application. This `POST` endpoint allows querying by `email`, `id`, or `referenceId`. Use only one field; priority is given to `email`, then `referenceId`, and finally `id` in the MuFi database.","href":"/docs/endpoint/wallets/fetch-users"},{"openapi":"post /v1/users/activate","title":"Activate User","href":"/docs/endpoint/wallets/activate-user"},{"openapi":"post /v1/users/activation","title":"User Activation Status","href":"/docs/endpoint/wallets/user-activation-status"},{"openapi":"post /v1/users/balances","title":"Get Wallet Balances","href":"/docs/endpoint/wallets/get-wallet-balances"},{"openapi":"get /v1/users/count","title":"Get User Count","href":"/docs/endpoint/wallets/get-user-count"}]},{"group":"Projects Endpoints","pages":[{"openapi":"get /v1/projects/wallets","title":"Fetch Wallets","href":"/docs/endpoint/wallets/fetch-wallets"}]}]},{"tab":"Events","pages":[{"title":"Events","href":"/docs/events/introduction"}]},{"tab":"Products","pages":[{"title":"Products","href":"/docs/products/introduction"}]}]},"basePath":"","title":"Fetch User - Mufi","buildId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","deploymentId":"dpl_41S5Z2jG9QnfDRwN1KZrLdBwj7DM","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DDP9JXtj.js","utils-8yQyvEtx.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-CBCFR8Sn.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-rQaXkUHa.js","snippetPresets-J5KpBTgV.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BVxVH4Cj.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BxdQ2vIi.js","shallow-BjV2tFiD.js","getApiPlaygroundDisplay-C_55tL4O.js","CodeSnippet-C0JpiCOC.js","CodeSnippets-w9Ps7djG.js","Page-DTNSD-0M.js","getPastedJson-BDfB-H8d.js","icon-g-kUkkO9.js","MethodPill-v4l6fq0h.js","DuplicateIcon-CvLo-CfU.js","createIcon-165clrrV.js","DynamicMarkdown-D3RQ-fEj.js","SectionHeading-vvo-3yLf.js","axios-vUo_bRtp.js","Markdown-CMT1uFWQ.js","clsx-C8f2yC9R.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CI2D8R2Y.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-k78Wrw_e.js"]}