{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Finta","description":"Finta syncs financial data from banks and payment processors to productivity tools like Airtable, Notion, Google Sheets, and Coda. Documentation for setup, integrations, and troubleshooting.","colors":{"primary":"#6E56CF","light":"#6E56CF","dark":"#6E56CF"},"logo":{"light":"https://mintcdn.com/finta-10/K_IMUIs0cBRtaWOM/logo/finta-logo-black-text.svg?fit=max\u0026auto=format\u0026n=K_IMUIs0cBRtaWOM\u0026q=85\u0026s=5a36e554ada8ffbb5ce2af670ed6c896","dark":"https://mintcdn.com/finta-10/K_IMUIs0cBRtaWOM/logo/finta-logo-white-text.svg?fit=max\u0026auto=format\u0026n=K_IMUIs0cBRtaWOM\u0026q=85\u0026s=91830ef558aa1cbc384361a0d73fb04b"},"favicon":"https://mintcdn.com/finta-10/jdclNcDGGc_u6oDw/favicon.png?fit=max\u0026auto=format\u0026n=jdclNcDGGc_u6oDw\u0026q=85\u0026s=91745403bceaa562ddca8d64c9a89ff6","background":{"color":{"dark":"#111111"}},"navbar":{"links":[{"href":"mailto:hello@finta.io","label":"Contact Us"}],"primary":{"type":"button","label":"Dashboard","href":"https://app.finta.io"}},"footer":{"socials":{"twitter":"https://twitter.com/FintaApp"}},"contextual":{"options":["assistant","copy","mcp","add-mcp"],"display":"header"},"styling":{"latex":true},"navigation":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://link.finta.io/discord"}]},"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"finta-10","hasAudioNarration":false,"actualSubdomain":"finta-10","customDomains":["docs.finta.io"],"gitSource":{"type":"github","owner":"fintaapp","repo":"monorepo","deployBranch":"main","contentDirectory":"apps/docs","isPrivate":false,"mountPath":"","label":""},"chroma":{"liveDeploymentHistoryId":"6ae96a4d9b3d2ce6fa8f0bcb","collectionId":"e858195b-cc90-4366-8984-82a40d6d3940","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae96a4d9b3d2ce6fa8f0bcb"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae96a4d9b3d2ce6fa8f0bcb","clientVersion":"0.0.4054","searchFilterCounts":[{"language":"default","tag":"API","count":50},{"language":"default","tag":"Reference","count":40},{"language":"default","tag":"Documentation","count":34},{"language":"default","tag":"Bank Connections","count":11},{"language":"default","tag":"Budgets","count":10},{"language":"default","tag":"MCP","count":9},{"language":"default","tag":"Destinations","count":8},{"language":"default","tag":"Accounts","count":7},{"language":"default","tag":"Getting Started","count":6},{"language":"default","tag":"Charts","count":5}]},"assistantConfig":{},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/investments/list-holdings","slug":"/api-reference/investments/list-holdings","pageMetadata":{"title":"List holdings","description":"Returns stored investment holdings from durable Finta data only. Does not call live providers.","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /holdings","href":"/api-reference/investments/list-holdings","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: \"Returns stored investment holdings from durable Finta data only. Does not call live providers.\"\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":{"title":"List holdings","description":"Returns stored investment holdings from durable Finta data only. Does not call live providers.","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /holdings","href":"/api-reference/investments/list-holdings","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"List holdings","description":"Returns stored investment holdings from durable Finta data only. Does not call live providers.","operationId":"listHoldingsV2","tags":["Investments"],"parameters":["21e47807-48c8-4895-b1b4-a028a5663427","3b5206d8-742b-48f3-aa63-39916db9874f","bc7a7ad3-7d2c-4902-a7c8-90f6cff41ffb","499edc9f-3248-4a4c-adc4-0f3f7f020c1b"],"responses":{"200":"c8cd1261-cf0a-4f7b-a23a-247f42964ff2","400":"922a675c-ea77-4370-8697-90a581825030","401":"2c376b6a-6157-48b5-a0fa-8709b087a0e7","403":"b493a452-1c84-4edd-92a8-42fc1313ae83","429":"51b4f68a-1635-430b-8ed8-a6a3a36a5795"},"method":"get","type":"path","servers":["0c23f4f7-1aab-4cf5-bc1a-4ed2407b6311"],"security":["1727483c-c96c-4f5e-8b2e-8832d482fd5b"],"path":"/holdings","baseUrlOptions":["https://api.finta.io/v2"],"title":"List holdings","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"21e47807-48c8-4895-b1b4-a028a5663427":{"name":"bankConnectionId","in":"query","required":false,"schema":{"type":"string","format":"uuid","isRequired":false,"description":"Filter by bank connection ID","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"Filter by bank connection ID"},"3b5206d8-742b-48f3-aa63-39916db9874f":{"name":"bankAccountId","in":"query","required":false,"schema":{"type":"string","format":"uuid","isRequired":false,"description":"Filter by bank account ID","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"Filter by bank account ID"},"bc7a7ad3-7d2c-4902-a7c8-90f6cff41ffb":{"name":"securityId","in":"query","required":false,"schema":{"type":"string","format":"uuid","isRequired":false,"description":"Filter by Finta security ID","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"Filter by Finta security ID"},"499edc9f-3248-4a4c-adc4-0f3f7f020c1b":{"name":"status","in":"query","required":false,"schema":{"type":"string","enum":["active","sold","all"],"default":"active","isRequired":false,"description":"Filter by holding lifecycle. `active` (default) excludes sold positions.","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"Filter by holding lifecycle. `active` (default) excludes sold positions."}},"responses":{"c8cd1261-cf0a-4f7b-a23a-247f42964ff2":{"description":"Holdings for the authenticated user","content":{"application/json":{"schema":{"type":"object","required":["holdings"],"properties":{"holdings":{"type":"array","items":{"type":"object","required":["id","bankConnectionId","bankAccountId","securityId","quantity","costBasis","currency","status","soldAt"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"holdings.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"bankConnectionId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"holdings.items.[INDEX].bankConnectionId","typeLabel":"string\u003cuuid>"},"bankAccountId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"holdings.items.[INDEX].bankAccountId","typeLabel":"string\u003cuuid>"},"securityId":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"holdings.items.[INDEX].securityId","typeLabel":"string\u003cuuid>"},"quantity":{"type":"number","isRequired":true,"uniqueKey":"holdings.items.[INDEX].quantity","typeLabel":"number"},"costBasis":{"oneOf":[{"type":"number","isRequired":true,"uniqueKey":"holdings.items.[INDEX].costBasis.oneOf.0","typeLabel":"number"},{"type":"null","isRequired":true,"uniqueKey":"holdings.items.[INDEX].costBasis.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"holdings.items.[INDEX].costBasis","typeLabel":"number | null"},"currency":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"holdings.items.[INDEX].currency.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"holdings.items.[INDEX].currency.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"holdings.items.[INDEX].currency","typeLabel":"string | null"},"status":{"type":"string","enum":["active","sold"],"isRequired":true,"uniqueKey":"holdings.items.[INDEX].status","typeLabel":"enum\u003cstring>"},"soldAt":{"oneOf":[{"type":"string","format":"date-time","isRequired":true,"uniqueKey":"holdings.items.[INDEX].soldAt.oneOf.0","typeLabel":"string\u003cdate-time>"},{"type":"null","format":"date-time","isRequired":true,"uniqueKey":"holdings.items.[INDEX].soldAt.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"holdings.items.[INDEX].soldAt","typeLabel":"string\u003cdate-time> | null"}},"uniqueKey":"holdings.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"holdings","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"holdings":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","bankConnectionId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","bankAccountId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","securityId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","quantity":123,"costBasis":123,"currency":"\u003cstring>","status":"active","soldAt":"2023-11-07T05:31:56Z"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"922a675c-ea77-4370-8697-90a581825030":{"description":"Invalid query parameters","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"STORAGE_MODE_REQUIRED","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"STORAGE_MODE_REQUIRED","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"2c376b6a-6157-48b5-a0fa-8709b087a0e7":{"description":"Missing or invalid API key","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string","example":"Missing or invalid Authorization header","isRequired":true,"uniqueKey":"error","typeLabel":"string"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Missing or invalid Authorization header"}}},"exampleType":"generated"}},"exampleType":"generated"},"b493a452-1c84-4edd-92a8-42fc1313ae83":{"description":"Storage mode required or subscription inactive","content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"STORAGE_MODE_REQUIRED","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":{"code":"STORAGE_MODE_REQUIRED","message":"\u003cstring>"}}}},"exampleType":"generated"}},"exampleType":"generated"},"51b4f68a-1635-430b-8ed8-a6a3a36a5795":{"description":"Rate limit exceeded","headers":{"Retry-After":{"description":"Seconds until the rate-limit window resets","schema":{"type":"integer"}}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"object","required":["code","message"],"properties":{"code":{"type":"string","example":"STORAGE_MODE_REQUIRED","isRequired":true,"uniqueKey":"error.code","typeLabel":"string"},"message":{"type":"string","isRequired":true,"uniqueKey":"error.message","typeLabel":"string"}},"isRequired":true,"uniqueKey":"error","typeLabel":"object"}},"uniqueKey":"","typeLabel":"object"},"example":{"error":{"code":"RATE_LIMITED","message":"Per-minute rate limit exceeded (standard plan)"}},"examples":{"Example":{"title":"Example","value":{"error":{"code":"RATE_LIMITED","message":"Per-minute rate limit exceeded (standard plan)"}}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"1727483c-c96c-4f5e-8b2e-8832d482fd5b":{"bearerAuth":{"type":"http","scheme":"bearer","description":"A Finta API key from API settings, or an OAuth access token issued to an authorized app. Send either as `Authorization: Bearer \u003ctoken>`.","scopes":[],"schemeName":"bearerAuth"}}},"servers":{"0c23f4f7-1aab-4cf5-bc1a-4ed2407b6311":{"url":"https://api.finta.io/v2","description":"Production server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"http","scheme":"bearer","description":"A Finta API key from API settings, or an OAuth access token issued to an authorized app. Send either as `Authorization: Bearer \u003ctoken>`.","scopes":[],"schemeName":"bearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"A Finta API key from API settings, or an OAuth access token issued to an authorized app. Send either as `Authorization: Bearer \u003ctoken>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"bearerAuth","name":"Authorization"}],"title":"bearerAuth"}]},"originalFileLocation":"api/v2/openapi.json"},"subdomain":"finta-10","siteName":"Finta","title":"List holdings - Finta","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-03T05:00:02.770Z","originalFileLocation":"api-reference/investments/list-holdings.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=\"system\"}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=\"Returns stored investment holdings from durable Finta data only. Does not call live providers.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Finta\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/finta-10/Jt7kz6C6qwcjCWVy/_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/finta-10/Jt7kz6C6qwcjCWVy/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/finta-10/Jt7kz6C6qwcjCWVy/_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/finta-10/Jt7kz6C6qwcjCWVy/_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/finta-10/Jt7kz6C6qwcjCWVy/_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/finta-10/Jt7kz6C6qwcjCWVy/_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/finta-10/Jt7kz6C6qwcjCWVy/_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/finta-10/Jt7kz6C6qwcjCWVy/_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/finta-10/Jt7kz6C6qwcjCWVy/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"List holdings - Finta\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns stored investment holdings from durable Finta data only. Does not call live providers.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Finta\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.finta.io/api-reference/investments/list-holdings\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://finta-10.mintlify.app/_mintlify/api/og/v2?division=Investments\u0026amp;title=List+holdings\u0026amp;description=Returns+stored+investment+holdings+from+durable+Finta+data+only.+Does+not+call+live+providers.\u0026amp;theme=ce8291f76a2c0db9e1376b0f\u0026amp;signature=971ebd4db55c67b9a42d8fe0239d3acc38a2e2cb9f69eb8d23039bd04e0d0a76\">\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=\"List holdings - Finta\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns stored investment holdings from durable Finta data only. Does not call live providers.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://finta-10.mintlify.app/_mintlify/api/og/v2?division=Investments\u0026amp;title=List+holdings\u0026amp;description=Returns+stored+investment+holdings+from+durable+Finta+data+only.+Does+not+call+live+providers.\u0026amp;theme=ce8291f76a2c0db9e1376b0f\u0026amp;signature=971ebd4db55c67b9a42d8fe0239d3acc38a2e2cb9f69eb8d23039bd04e0d0a76\">\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/finta-10/Jt7kz6C6qwcjCWVy/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Finta\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#6E56CF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.finta.io/api-reference/investments/list-holdings\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/investments/list-holdings.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.finta.io/#organization\",\"name\":\"Finta\",\"url\":\"https://docs.finta.io\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/finta-10/K_IMUIs0cBRtaWOM/logo/finta-logo-black-text.svg?fit=max\u0026auto=format\u0026n=K_IMUIs0cBRtaWOM\u0026q=85\u0026s=5a36e554ada8ffbb5ce2af670ed6c896\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.finta.io#website\",\"name\":\"Finta\",\"url\":\"https://docs.finta.io\",\"publisher\":{\"@id\":\"https://docs.finta.io/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.finta.io/api-reference/investments/list-holdings#webpage\",\"url\":\"https://docs.finta.io/api-reference/investments/list-holdings\",\"name\":\"List holdings\",\"description\":\"Returns stored investment holdings from durable Finta data only. Does not call live providers.\",\"dateModified\":\"2026-11-03T05:00:02.770Z\",\"isPartOf\":{\"@id\":\"https://docs.finta.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.finta.io/api-reference/investments/list-holdings#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.finta.io/api-reference/investments/list-holdings#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reference\",\"item\":\"https://docs.finta.io/api-reference/health/health-check\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Investments\",\"item\":\"https://docs.finta.io/api-reference/investments/list-securities\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"List holdings\",\"item\":\"https://docs.finta.io/api-reference/investments/list-holdings\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.finta.io/api-reference/investments/list-holdings#apireference\",\"headline\":\"List holdings\",\"name\":\"List holdings\",\"description\":\"Returns stored investment holdings from durable Finta data only. Does not call live providers.\",\"url\":\"https://docs.finta.io/api-reference/investments/list-holdings\",\"mainEntityOfPage\":{\"@id\":\"https://docs.finta.io/api-reference/investments/list-holdings#webpage\"},\"dateModified\":\"2026-11-03T05:00:02.770Z\",\"publisher\":{\"@id\":\"https://docs.finta.io/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.finta.io#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Finta\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Finta","nav":{"global":{"anchors":[{"anchor":"Community","icon":"discord","href":"https://link.finta.io/discord"}]},"tabs":[{"tab":"Documentation","icon":"book-open","pages":[{"title":"Documentation","href":"/introduction"}]},{"tab":"API","icon":"code","groups":[{"group":"API","pages":[{"title":"Overview","href":"/api/v2/overview"},{"title":"Authentication","href":"/api/v2/authentication"},{"title":"API Keys","href":"/api/v2/api-keys"},{"title":"Data Types","href":"/api/v2/data-types"},{"title":"Budgets","href":"/api/v2/budgets"}]},{"group":"Reference","pages":[{"group":"Health","pages":[{"title":"Health Check","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /health","href":"/api-reference/health/health-check"}]},{"group":"Bank Connections","pages":[{"title":"List bank connections","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /bank-connections","href":"/api-reference/bank-connections/list-bank-connections"}]},{"group":"Me","pages":[{"title":"Current API user","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /me","href":"/api-reference/me/current-api-user"}]},{"group":"Accounts","pages":[{"title":"List accounts","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /accounts","href":"/api-reference/accounts/list-accounts"},{"title":"Create a manual account","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json post /accounts","href":"/api-reference/accounts/create-a-manual-account"},{"title":"List balance history","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /accounts/balance-history","href":"/api-reference/accounts/list-balance-history"},{"title":"Get account","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /accounts/{accountId}","href":"/api-reference/accounts/get-account"},{"title":"Delete a manual account","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json delete /accounts/{accountId}","href":"/api-reference/accounts/delete-a-manual-account"},{"title":"Update a manual account","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json patch /accounts/{accountId}","href":"/api-reference/accounts/update-a-manual-account"},{"title":"List account balance history","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /accounts/{accountId}/balance-history","href":"/api-reference/accounts/list-account-balance-history"}]},{"group":"Investments","pages":[{"title":"List securities","description":"Returns securities referenced by the authenticated user holdings or investment transactions. Does not call live providers.","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /securities","href":"/api-reference/investments/list-securities"},{"title":"List holdings","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /holdings","href":"/api-reference/investments/list-holdings"},{"title":"List investment transactions","description":"Returns stored investment transactions from durable Finta data only. Supports cursor pagination.","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /investment-transactions","href":"/api-reference/investments/list-investment-transactions"}]},{"group":"Transactions","pages":[{"title":"List transactions","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /transactions","href":"/api-reference/transactions/list-transactions"},{"title":"Update a transaction","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json patch /transactions/{id}","href":"/api-reference/transactions/update-a-transaction"},{"title":"Batch update transactions","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json post /transactions/batch","href":"/api-reference/transactions/batch-update-transactions"}]},{"group":"Categories","pages":[{"title":"List categories","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /categories","href":"/api-reference/categories/list-categories"},{"title":"Create a category","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json post /categories","href":"/api-reference/categories/create-a-category"},{"title":"Batch update categories","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json post /categories/batch","href":"/api-reference/categories/batch-update-categories"},{"title":"Delete a category","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json delete /categories/{id}","href":"/api-reference/categories/delete-a-category"},{"title":"Update a category","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json patch /categories/{id}","href":"/api-reference/categories/update-a-category"}]},{"group":"Category Groups","pages":[{"title":"List category groups","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /category-groups","href":"/api-reference/category-groups/list-category-groups"},{"title":"Create a category group","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json post /category-groups","href":"/api-reference/category-groups/create-a-category-group"},{"title":"Delete a category group","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json delete /category-groups/{id}","href":"/api-reference/category-groups/delete-a-category-group"},{"title":"Update a category group","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json patch /category-groups/{id}","href":"/api-reference/category-groups/update-a-category-group"}]},{"group":"Rules","pages":[{"title":"List transaction rules","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /rules","href":"/api-reference/rules/list-transaction-rules"},{"title":"Create a transaction rule","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json post /rules","href":"/api-reference/rules/create-a-transaction-rule"},{"title":"Run transaction rules","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json post /rules/run","href":"/api-reference/rules/run-transaction-rules"},{"title":"Archive a transaction rule","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json delete /rules/{ruleId}","href":"/api-reference/rules/archive-a-transaction-rule"},{"title":"Update a transaction rule","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json patch /rules/{ruleId}","href":"/api-reference/rules/update-a-transaction-rule"}]},{"group":"Budgets","pages":[{"title":"List budget plans","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /budget-plans","href":"/api-reference/budgets/list-budget-plans"},{"title":"Create a budget plan","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json post /budget-plans","href":"/api-reference/budgets/create-a-budget-plan"},{"title":"Delete a budget plan","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json delete /budget-plans/{id}","href":"/api-reference/budgets/delete-a-budget-plan"},{"title":"Update a budget plan","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json patch /budget-plans/{id}","href":"/api-reference/budgets/update-a-budget-plan"},{"title":"List budgets","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /budgets","href":"/api-reference/budgets/list-budgets"},{"title":"Set a budget","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json post /budgets","href":"/api-reference/budgets/set-a-budget"},{"title":"Move money between budgets","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json post /budgets/reallocate","href":"/api-reference/budgets/move-money-between-budgets"},{"title":"Get budget status","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /budgets/status","href":"/api-reference/budgets/get-budget-status"},{"title":"Delete a budget","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json delete /budgets/{id}","href":"/api-reference/budgets/delete-a-budget"},{"title":"Update a budget","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json patch /budgets/{id}","href":"/api-reference/budgets/update-a-budget"}]}]}]},{"tab":"MCP","icon":"plug","pages":[{"title":"MCP","href":"/mcp/overview"}]}]},"basePath":"","title":"List holdings - Finta","buildId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","deploymentId":"dpl_345ReqzYaAjzS9QpeJemsKdb7KDj","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-C8RPHPxo.js","utils-0BK-9q6z.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-DfjzsUJT.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-B4v9psJ4.js","snippetPresets-CpTQv-Ez.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-BNP-Fvr0.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BSgu6h1D.js","shallow-Biv1i9Gs.js","getApiPlaygroundDisplay-BoGOXhtF.js","CodeSnippet-DvQoT18_.js","CodeSnippets-Dnpa15xT.js","Page-Buji1S4J.js","getPastedJson-xAIyhUFE.js","icon-S6FBih11.js","MethodPill-SaYeUZyk.js","DuplicateIcon-Cs-p3v2Q.js","createIcon-DjCFEoHq.js","DynamicMarkdown-BcnBltEQ.js","SectionHeading-BUBl0eEF.js","axios-vUo_bRtp.js","Markdown-h4cOoD8d.js","clsx-B2v50t8t.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DJnKvr0g.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BHrrjR1K.js"]}