{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Demat Escrow API","description":"Secret-key API reference for Demat Escrow — customers, holds, checkout, wallets, payouts, and webhooks.","colors":{"primary":"#5D2E8F","light":"#A78BDB","dark":"#4A2472"},"logo":{"light":"https://mintcdn.com/demat-shop-enterprise/38IVRaUbZVGwAsgT/logo/light.svg?fit=max\u0026auto=format\u0026n=38IVRaUbZVGwAsgT\u0026q=85\u0026s=9a76cf5cc9bfa666a81246563036733e","dark":"https://mintcdn.com/demat-shop-enterprise/38IVRaUbZVGwAsgT/logo/dark.svg?fit=max\u0026auto=format\u0026n=38IVRaUbZVGwAsgT\u0026q=85\u0026s=f3c9d161643cb3bc4d3390eabb34bb7c","href":"https://usedemat.com"},"favicon":"https://mintcdn.com/demat-shop-enterprise/38IVRaUbZVGwAsgT/favicon.svg?fit=max\u0026auto=format\u0026n=38IVRaUbZVGwAsgT\u0026q=85\u0026s=ddbc4d2ba3c1ca578a6f5d76d5c1767b","api":{"playground":{"display":"interactive"},"examples":{"defaults":"required","languages":["curl","node","python"],"prefill":true}},"appearance":{"default":"light"},"background":{"decoration":"gradient","color":{"light":"#FAF8FC","dark":"#120E18"}},"navbar":{"links":[{"href":"https://merchant.usedemat.com","label":"Dashboard"},{"href":"https://merchant.usedemat.com","label":"Website"}],"primary":{"type":"button","label":"Get API keys","href":"https://merchant.usedemat.com"}},"fonts":{"family":"Jost"},"icons":{"library":"lucide"},"styling":{"eyebrows":"breadcrumbs","codeblocks":{"theme":{"light":"github-light","dark":"github-dark"}},"latex":false},"contextual":{"options":["copy","view","chatgpt","claude","cursor"],"display":"header"},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"demat-shop-enterprise","hasAudioNarration":false,"actualSubdomain":"demat-shop-enterprise","customDomains":["docs.usedemat.com"],"gitSource":{"type":"github","owner":"hostel-paddy","repo":"demat-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"chroma":{"latestBuiltDeploymentHistoryId":"6ac2d50b3605e3b2ae6e5fd6","collectionId":"9878f90a-45ce-461b-9f69-15fd3489d6ad","liveDeploymentHistoryId":"6ac2d50b3605e3b2ae6e5fd6","schemaVersion":"v3"},"entitlements":{"AI_CHAT":{"status":"DISABLED"},"WEB_MCP":{"status":"DISABLED"},"NARRATION":{"status":"DISABLED"}},"buildId":"6ad7c4af2b5ff80356f2de6b","clientVersion":"0.0.3902","searchFilterCounts":[{"language":"default","tag":"API Reference","count":32},{"language":"default","tag":"Guides","count":11},{"language":"default","tag":"escrows","count":9},{"language":"default","tag":"API basics","count":6},{"language":"default","tag":"customers","count":5},{"language":"default","tag":"checkout","count":4},{"language":"default","tag":"wallets","count":4},{"language":"default","tag":"Get started","count":3},{"language":"default","tag":"identity","count":3},{"language":"default","tag":"payouts","count":3}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","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":"editor-v7-file-tree","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":"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":"pause-universal-search-reconcile","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":"per-site-search-delta","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":"editor-branches-v2-autocommit","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-branches-v2","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":"editor-private-page-search","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":"teamspace","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-nav-generations","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":"byok-sep-25","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":"editor-agent-model-picker","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"client-snapshot-docs-config","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}],"isAtlas":false,"googleFontsInlined":true},"customCss":[{"filePath":"style.css","content":":root{--demat-purple:#5d2e8f;--demat-purple-soft:#f3eef8;--demat-orange:#faa51e;--demat-ink:#1e1528;--demat-muted:#5c5268}::selection{background:rgba(93,46,143,.18);color:var(--demat-ink)}#navbar img,#navbar svg,#navbar-logo img,#navbar-logo svg{max-height:28px;width:auto}#page-title{letter-spacing:-.02em;color:var(--demat-ink);font-weight:600}#content-area h2,#content-area h3,#content-area th{letter-spacing:-.015em;color:var(--demat-ink)}#content-area li,#content-area p{color:var(--demat-muted);line-height:1.7}#topbar-cta-button{background:var(--demat-purple)!important;border-color:transparent!important;box-shadow:0 1px 0 rgba(93,46,143,.15)}#topbar-cta-button:hover{background:#4a2472!important}#content-area a[class*=card],#content-area a[href].card{border-radius:12px;border-color:#ebe4f3!important;background:rgba(255,255,255,.8)!important;transition:border-color .15s ease,box-shadow .15s ease}#content-area a[class*=card]:hover,#content-area a[href].card:hover{border-color:#d8c8ea!important;box-shadow:0 8px 24px rgba(93,46,143,.08)}#content-area table{border-collapse:separate;border-spacing:0;overflow:hidden;border-radius:10px}#content-area th{background:var(--demat-purple-soft);font-weight:600;letter-spacing:-.01em}#content-area td{border-color:#eee8f4}#content-area tr:hover td{background:#fcfaff}#content-area :not(pre)>code{background:var(--demat-purple-soft);color:var(--demat-purple);border-radius:5px;padding:.12em .38em;font-weight:500}#sidebar a[aria-current=page]{color:var(--demat-purple)!important}#page-title::after{content:\"\";display:block;width:2.5rem;height:3px;margin-top:.85rem;border-radius:999px;background:linear-gradient(90deg,var(--demat-orange),var(--demat-purple))}#header,#pagination{border-color:#efe8f6}.dark ::selection{background:rgba(167,139,219,.28);color:#f4eefc}.dark #content-area h2,.dark #content-area h3,.dark #page-title{color:#f4eefc}.dark #content-area li,.dark #content-area p{color:#b7aec6}.dark #content-area th{background:#1c1526;color:#f4eefc}.dark #content-area :not(pre)>code{background:#241b30;color:#cbb6ef}.dark #content-area a[class*=card],.dark #content-area a[href].card{background:rgba(24,18,31,.85)!important;border-color:#2e243c!important}.dark #header,.dark #pagination{border-color:#2a2235}"}],"page":{"pagePath":"api-reference/wallets/get-a-wallet-and-balances","slug":"/api-reference/wallets/get-a-wallet-and-balances","pageMetadata":{"title":"Get a wallet and balances","description":"Fetch one wallet: available/held balances and optional virtual-account details.","deprecated":null,"version":null,"openapi":"/openapi.json get /wallets/{walletId}","href":"/api-reference/wallets/get-a-wallet-and-balances","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Fetch one wallet: available/held balances and optional virtual-account details.\"\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":{"codeStyling":{"theme":{"light":"github-light","dark":"github-dark"}},"config":{},"pageMetadata":{"title":"Get a wallet and balances","description":"Fetch one wallet: available/held balances and optional virtual-account details.","deprecated":null,"version":null,"openapi":"/openapi.json get /wallets/{walletId}","href":"/api-reference/wallets/get-a-wallet-and-balances","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"operationId":"WalletController_get","parameters":["862421ae-6fa0-49ff-8753-6b290276ae53"],"responses":{"200":"e8097ac1-8f51-4a4c-a518-d13985e420fa","401":"382473cd-b4bc-42c1-8881-9d394ece152b","404":"2a006cb0-f882-458c-a5f0-ac86050aacce"},"security":["e00a38e4-0557-4e51-99a9-07a844516f8f"],"summary":"Get a wallet and balances","tags":["wallets"],"description":"Fetch one wallet: available/held balances and optional virtual-account details.","method":"get","type":"path","servers":["409dd45c-8f2a-49e0-8e00-041fc26564cb"],"path":"/wallets/{walletId}","baseUrlOptions":["{baseUrl}"],"title":"Get a wallet and balances","codeSamples":[],"requestExampleLanguages":["bash","node","python"],"requiredOnlyExamples":true,"requestExampleType":"generated","responseExampleType":"generated","prefillPlaygroundWithExample":true,"prefillPlaygroundExamples":[]},"dependencies":{"parameters":{"862421ae-6fa0-49ff-8753-6b290276ae53":{"name":"walletId","required":true,"in":"path","schema":{"type":"string","isRequired":true,"uniqueKey":"","typeLabel":"string"}}},"responses":{"e8097ac1-8f51-4a4c-a518-d13985e420fa":{"description":"Request succeeded","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":true,"uniqueKey":"success","typeLabel":"boolean"},"data":{"type":"object","properties":{"walletId":{"type":"string","example":"wal_01hxyz","isRequired":true,"uniqueKey":"data.walletId","typeLabel":"string"},"customerId":{"type":"string","example":"cus_01hxyz","isRequired":true,"uniqueKey":"data.customerId","typeLabel":"string"},"balances":{"type":"object","properties":{"available":{"type":"number","example":0,"description":"Withdrawable balance in naira, as stored.","isRequired":true,"uniqueKey":"data.balances.available","typeLabel":"number"},"held":{"type":"number","example":0,"description":"Balance locked in open escrows, in naira, as stored.","isRequired":true,"uniqueKey":"data.balances.held","typeLabel":"number"}},"required":["available","held"],"isRequired":true,"uniqueKey":"data.balances","typeLabel":"object"},"account":{"oneOf":[{"type":"object","required":["currency"],"properties":{"currency":{"type":"string","example":"NGN","isRequired":true,"uniqueKey":"data.account.oneOf.0.currency","typeLabel":"string"},"accountNumber":{"oneOf":[{"type":"string","example":"0123456789","uniqueKey":"data.account.oneOf.0.accountNumber.oneOf.0","typeLabel":"string"},{"type":"null","example":"0123456789","uniqueKey":"data.account.oneOf.0.accountNumber.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.account.oneOf.0.accountNumber","typeLabel":"string | null"},"accountName":{"oneOf":[{"type":"string","example":"Jane Doe","uniqueKey":"data.account.oneOf.0.accountName.oneOf.0","typeLabel":"string"},{"type":"null","example":"Jane Doe","uniqueKey":"data.account.oneOf.0.accountName.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.account.oneOf.0.accountName","typeLabel":"string | null"},"bankName":{"oneOf":[{"type":"string","example":"Wema Bank","uniqueKey":"data.account.oneOf.0.bankName.oneOf.0","typeLabel":"string"},{"type":"null","example":"Wema Bank","uniqueKey":"data.account.oneOf.0.bankName.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.account.oneOf.0.bankName","typeLabel":"string | null"},"bankCode":{"oneOf":[{"type":"string","example":"035","uniqueKey":"data.account.oneOf.0.bankCode.oneOf.0","typeLabel":"string"},{"type":"null","example":"035","uniqueKey":"data.account.oneOf.0.bankCode.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.account.oneOf.0.bankCode","typeLabel":"string | null"},"provider":{"oneOf":[{"type":"string","uniqueKey":"data.account.oneOf.0.provider.oneOf.0","typeLabel":"string"},{"type":"null","uniqueKey":"data.account.oneOf.0.provider.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.account.oneOf.0.provider","typeLabel":"string | null"}},"uniqueKey":"data.account.oneOf.0","typeLabel":"object"},{"type":"null","uniqueKey":"data.account.oneOf.1","typeLabel":"null"}],"uniqueKey":"data.account","typeLabel":"object | null"}},"required":["walletId","customerId","balances"],"uniqueKey":"data","typeLabel":"object"},"meta":{"type":"object","properties":{"requestId":{"type":"string","example":"req_01hxyz","isRequired":true,"uniqueKey":"meta.requestId","typeLabel":"string"}},"required":["requestId"],"uniqueKey":"meta","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":true,"data":{"walletId":"wal_01hxyz","customerId":"cus_01hxyz","balances":{"available":0,"held":0},"account":{"currency":"NGN","accountNumber":"0123456789","accountName":"Jane Doe","bankName":"Wema Bank","bankCode":"035","provider":"\u003cstring>"}},"meta":{"requestId":"req_01hxyz"}}}},"exampleType":"generated"}},"exampleType":"generated"},"382473cd-b4bc-42c1-8881-9d394ece152b":{"description":"Missing or invalid credentials","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string","example":"INVALID_REQUEST","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"Invalid request","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"example":{},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","properties":{"requestId":{"type":"string","example":"req_01hxyz","isRequired":true,"uniqueKey":"meta.requestId","typeLabel":"string"}},"required":["requestId"],"isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"required":["success","error","meta"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"INVALID_REQUEST","message":"Invalid request","details":{}},"meta":{"requestId":"req_01hxyz"}}}},"exampleType":"generated"}},"exampleType":"generated"},"2a006cb0-f882-458c-a5f0-ac86050aacce":{"description":"Resource not found","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","example":false,"isRequired":true,"uniqueKey":"success","typeLabel":"boolean"},"error":{"type":"object","properties":{"code":{"type":"string","example":"INVALID_REQUEST","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","example":"Invalid request","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"},"details":{"type":"object","additionalProperties":true,"example":{},"isRequired":true,"uniqueKey":"error.details","typeLabel":"object"}},"required":["code","message","details"],"isRequired":true,"uniqueKey":"error","typeLabel":"object"},"meta":{"type":"object","properties":{"requestId":{"type":"string","example":"req_01hxyz","isRequired":true,"uniqueKey":"meta.requestId","typeLabel":"string"}},"required":["requestId"],"isRequired":true,"uniqueKey":"meta","typeLabel":"object"}},"required":["success","error","meta"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"success":false,"error":{"code":"INVALID_REQUEST","message":"Invalid request","details":{}},"meta":{"requestId":"req_01hxyz"}}}},"exampleType":"generated"}},"exampleType":"generated"}},"security":{"e00a38e4-0557-4e51-99a9-07a844516f8f":{"bearer":{"scheme":"bearer","bearerFormat":"Secret Key","type":"http","description":"Secret API key. Use `sk_test_...` for sandbox data or `sk_live_...` for live data (after verification and live mode). Do not use `pk_` keys.","scopes":[]}}},"servers":{"409dd45c-8f2a-49e0-8e00-041fc26564cb":{"url":"{baseUrl}","description":"API base URL. type your host here","variables":{"baseUrl":{"default":"https://prod.demat.shop/api/v1","description":"Full base URL including /api/v1. Change this for local development if needed."}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"scheme":"bearer","bearerFormat":"Secret Key","type":"http","description":"Secret API key. Use `sk_test_...` for sandbox data or `sk_live_...` for live data (after verification and live mode). Do not use `pk_` keys.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Secret API key. Use `sk_test_...` for sandbox data or `sk_live_...` for live data (after verification and live mode). Do not use `pk_` keys.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearer","name":"Authorization"}],"title":"bearer"}]},"originalFileLocation":"openapi.json"},"subdomain":"demat-shop-enterprise","siteName":"Demat Escrow API","title":"Get a wallet and balances - Demat Escrow API","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-10-04T22:37:03.415Z","originalFileLocation":"api-reference/wallets/get-a-wallet-and-balances.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;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=\"light\"}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=\"Fetch one wallet: available/held balances and optional virtual-account details.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Demat Escrow API\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/demat-shop-enterprise/oBWYcEk0DmNgXDmM/_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/demat-shop-enterprise/oBWYcEk0DmNgXDmM/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/demat-shop-enterprise/oBWYcEk0DmNgXDmM/_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/demat-shop-enterprise/oBWYcEk0DmNgXDmM/_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/demat-shop-enterprise/oBWYcEk0DmNgXDmM/_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/demat-shop-enterprise/oBWYcEk0DmNgXDmM/_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/demat-shop-enterprise/oBWYcEk0DmNgXDmM/_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/demat-shop-enterprise/oBWYcEk0DmNgXDmM/_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/demat-shop-enterprise/oBWYcEk0DmNgXDmM/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get a wallet and balances - Demat Escrow API\">\u003cmeta data-mint-head property=\"og:description\" content=\"Fetch one wallet: available/held balances and optional virtual-account details.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Demat Escrow API\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.usedemat.com/api-reference/wallets/get-a-wallet-and-balances\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Get a wallet and balances - Demat Escrow API\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Fetch one wallet: available/held balances and optional virtual-account details.\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/demat-shop-enterprise/oBWYcEk0DmNgXDmM/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Demat Escrow API\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#5D2E8F\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.usedemat.com/api-reference/wallets/get-a-wallet-and-balances\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/wallets/get-a-wallet-and-balances.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.usedemat.com/#organization\",\"name\":\"Demat Escrow API\",\"url\":\"https://docs.usedemat.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/demat-shop-enterprise/38IVRaUbZVGwAsgT/logo/light.svg?fit=max\u0026auto=format\u0026n=38IVRaUbZVGwAsgT\u0026q=85\u0026s=9a76cf5cc9bfa666a81246563036733e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.usedemat.com#website\",\"name\":\"Demat Escrow API\",\"url\":\"https://docs.usedemat.com\",\"publisher\":{\"@id\":\"https://docs.usedemat.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.usedemat.com/api-reference/wallets/get-a-wallet-and-balances#webpage\",\"url\":\"https://docs.usedemat.com/api-reference/wallets/get-a-wallet-and-balances\",\"name\":\"Get a wallet and balances\",\"description\":\"Fetch one wallet: available/held balances and optional virtual-account details.\",\"dateModified\":\"2026-10-04T22:37:03.415Z\",\"isPartOf\":{\"@id\":\"https://docs.usedemat.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.usedemat.com/api-reference/wallets/get-a-wallet-and-balances#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.usedemat.com/api-reference/wallets/get-a-wallet-and-balances#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"wallets\",\"item\":\"https://docs.usedemat.com/api-reference/wallets/list-wallets\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get a wallet and balances\",\"item\":\"https://docs.usedemat.com/api-reference/wallets/get-a-wallet-and-balances\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.usedemat.com/api-reference/wallets/get-a-wallet-and-balances#apireference\",\"headline\":\"Get a wallet and balances\",\"name\":\"Get a wallet and balances\",\"description\":\"Fetch one wallet: available/held balances and optional virtual-account details.\",\"url\":\"https://docs.usedemat.com/api-reference/wallets/get-a-wallet-and-balances\",\"mainEntityOfPage\":{\"@id\":\"https://docs.usedemat.com/api-reference/wallets/get-a-wallet-and-balances#webpage\"},\"dateModified\":\"2026-10-04T22:37:03.415Z\",\"publisher\":{\"@id\":\"https://docs.usedemat.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.usedemat.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Demat Escrow API\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Demat Escrow API","nav":{"global":null,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":""}]},{"tab":"API Reference","groups":[{"group":"customers","pages":[{"title":"List customers","deprecated":null,"version":null,"openapi":"/openapi.json get /customers","href":"/api-reference/customers/list-customers"},{"title":"Create a customer","deprecated":null,"version":null,"openapi":"/openapi.json post /customers","href":"/api-reference/customers/create-a-customer"},{"title":"Get a customer","deprecated":null,"version":null,"openapi":"/openapi.json get /customers/{customerId}","href":"/api-reference/customers/get-a-customer"},{"title":"Delete a customer","deprecated":null,"version":null,"openapi":"/openapi.json delete /customers/{customerId}","href":"/api-reference/customers/delete-a-customer"},{"title":"Update a customer","deprecated":null,"version":null,"openapi":"/openapi.json patch /customers/{customerId}","href":"/api-reference/customers/update-a-customer"}]},{"group":"escrows","pages":[{"title":"List escrows","deprecated":null,"version":null,"openapi":"/openapi.json get /escrows","href":"/api-reference/escrows/list-escrows"},{"title":"Create an escrow","deprecated":null,"version":null,"openapi":"/openapi.json post /escrows","href":"/api-reference/escrows/create-an-escrow"},{"title":"Get an escrow","deprecated":null,"version":null,"openapi":"/openapi.json get /escrows/{escrowId}","href":"/api-reference/escrows/get-an-escrow"},{"title":"Cancel an unfunded escrow","deprecated":null,"version":null,"openapi":"/openapi.json post /escrows/{escrowId}/cancel","href":"/api-reference/escrows/cancel-an-unfunded-escrow"},{"title":"Get the dispute on an escrow","deprecated":null,"version":null,"openapi":"/openapi.json get /escrows/{escrowId}/disputes","href":"/api-reference/escrows/get-the-dispute-on-an-escrow"},{"title":"Open a dispute on a held escrow","deprecated":null,"version":null,"openapi":"/openapi.json post /escrows/{escrowId}/disputes","href":"/api-reference/escrows/open-a-dispute-on-a-held-escrow"},{"title":"Resolve a dispute by release, refund, or split","deprecated":null,"version":null,"openapi":"/openapi.json post /escrows/{escrowId}/disputes/{disputeId}/resolve","href":"/api-reference/escrows/resolve-a-dispute-by-release-refund-or-split"},{"title":"Refund held funds","deprecated":null,"version":null,"openapi":"/openapi.json post /escrows/{escrowId}/refund","href":"/api-reference/escrows/refund-held-funds"},{"title":"Release held funds","deprecated":null,"version":null,"openapi":"/openapi.json post /escrows/{escrowId}/release","href":"/api-reference/escrows/release-held-funds"}]},{"group":"checkout","pages":[{"title":"Get a public checkout session","deprecated":null,"version":null,"openapi":"/openapi.json get /checkout/public/{checkoutToken}","href":"/api-reference/checkout/get-a-public-checkout-session"},{"title":"List checkout sessions","deprecated":null,"version":null,"openapi":"/openapi.json get /checkout/sessions","href":"/api-reference/checkout/list-checkout-sessions"},{"title":"Create a checkout session","deprecated":null,"version":null,"openapi":"/openapi.json post /checkout/sessions","href":"/api-reference/checkout/create-a-checkout-session"},{"title":"Get a checkout session","deprecated":null,"version":null,"openapi":"/openapi.json get /checkout/sessions/{checkoutId}","href":"/api-reference/checkout/get-a-checkout-session"}]},{"group":"transactions","pages":[{"title":"List transactions","deprecated":null,"version":null,"openapi":"/openapi.json get /transactions","href":"/api-reference/transactions/list-transactions"},{"title":"Export transactions","deprecated":null,"version":null,"openapi":"/openapi.json get /transactions/export","href":"/api-reference/transactions/export-transactions"},{"title":"Get a transaction","deprecated":null,"version":null,"openapi":"/openapi.json get /transactions/{transactionId}","href":"/api-reference/transactions/get-a-transaction"}]},{"group":"wallets","pages":[{"title":"List wallets","deprecated":null,"version":null,"openapi":"/openapi.json get /wallets","href":"/api-reference/wallets/list-wallets"},{"title":"Provision a customer NUBAN wallet","description":"Verify the customer’s BVN (name must match) and assign a NUBAN if they do not already have one. Creating a customer already created a zero-balance wallet row. this call attaches the account. Test secret keys get a dummy Test Bank number. Live inbound transfers to that NUBAN credit available only; they do not lock a hold.","deprecated":null,"version":null,"openapi":"/openapi.json post /wallets","href":"/api-reference/wallets/provision-a-customer-nuban-wallet"},{"title":"Get a wallet and balances","deprecated":null,"version":null,"openapi":"/openapi.json get /wallets/{walletId}","href":"/api-reference/wallets/get-a-wallet-and-balances"},{"title":"Simulate a NUBAN credit","description":"Simulate an inbound NUBAN credit. Test secret keys only. Credits available only. same as a live dedicated-account transfer. Does not lock a hold. Send naira (200 for ₦200). Webhook: wallet.credited.","deprecated":null,"version":null,"openapi":"/openapi.json post /wallets/{walletId}/credits","href":"/api-reference/wallets/simulate-a-nuban-credit"}]},{"group":"payouts","pages":[{"title":"List withdrawals","deprecated":null,"version":null,"openapi":"/openapi.json get /withdrawals","href":"/api-reference/payouts/list-withdrawals"},{"title":"Send a customer’s available balance to a bank account","deprecated":null,"version":null,"openapi":"/openapi.json post /withdrawals","href":"/api-reference/payouts/send-a-customer’s-available-balance-to-a-bank-account"},{"title":"Get a withdrawal","deprecated":null,"version":null,"openapi":"/openapi.json get /withdrawals/{withdrawalId}","href":"/api-reference/payouts/get-a-withdrawal"}]},{"group":"fees","pages":[{"title":"Quote transaction fees","deprecated":null,"version":null,"openapi":"/openapi.json get /fees","href":"/api-reference/fees/quote-transaction-fees"}]},{"group":"identity","pages":[{"title":"Verify a bank account","deprecated":null,"version":null,"openapi":"/openapi.json post /identity/bank-accounts/verify","href":"/api-reference/identity/verify-a-bank-account"},{"title":"List supported banks","deprecated":null,"version":null,"openapi":"/openapi.json get /identity/banks","href":"/api-reference/identity/list-supported-banks"},{"title":"Look up NIN or BVN","deprecated":null,"version":null,"openapi":"/openapi.json post /identity/lookups","href":"/api-reference/identity/look-up-nin-or-bvn"}]}]}]},"title":"Get a wallet and balances - Demat Escrow API","buildId":"dpl_C3fsfi1EcrBns9Vx91gUSN1X3Hi4","deploymentId":"dpl_C3fsfi1EcrBns9Vx91gUSN1X3Hi4","dynamics":["c2aa737661","b0f84f53ff","a9bb46feb3","2b790eda92"],"chunks":["OpenApiReferenceProvider-WsdpkmZS.js","utils-v3NXaRhE.js","cloneDeep-CsK1MRZH.js","_Uint8Array-JMZMJLdF.js","isArray-CXeVWmfx.js","isObject-Bw72BMo0.js","utils-BM0BJrb-.js","toString-Ci69GPsS.js","addUniqueKeysToSchema-xblj_90j.js","snippetPresets-v8MhBpsI.js","style-to-object-8s5bpEGF.js","v4-DIgz8zy6.js","Page-Dh1M83X1.js","ApiExamples-DTqFH4GC.js","isEqual-XZWsFdP7.js","usePlaygroundInputsStore-0j65DmWp.js","shallow-C9R2KsR3.js","getApiPlaygroundDisplay-k5gpc1DM.js","ChevronDownIcon-Cct7NMX_.js","CodeSnippet-BVFHrHqS.js","CodeSnippets-5tSwXuDE.js","getPastedJson-B8csGquB.js","icon-BUUJSQVu.js","MethodPill-CxJla7Dc.js","DynamicMarkdown-B-Kaxar8.js","SectionHeading-xtHIDzye.js","PlusIcon-DYlJbUaT.js","TrashIcon-CUC6PAPm.js","axios-CXgqDoFS.js","Markdown-DxJDlEO9.js","clsx-Cm_RkB1d.js","lib-DnkIZQB2.js","lib-q-9GBWeW.js","html-void-elements-mCSPHezU.js","dist-C4WbBOfn.js","katex-Cnv50rb0.js","marked.esm-BKo0Hl1x.js","AssistantPageLink-C-MOkQdJ.js"]}