{"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":"6ae92aa08e826b84130008b4","collectionId":"7bb5efac-92dd-4150-a5d7-24f8b349c694","schemaVersion":"v3","latestBuiltDeploymentHistoryId":"6ae92aa08e826b84130008b4"},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6ae96a4d9b3d2ce6fa8f0bcb","clientVersion":"0.0.4045","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":[{"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":"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":"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":"byok-sep-25","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":"vite-origin","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-updated-9-15","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":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"api-reference/categories/list-categories","slug":"/api-reference/categories/list-categories","pageMetadata":{"title":"List categories","description":"Returns stored transaction categories from durable Finta data only.","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /categories","href":"/api-reference/categories/list-categories","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 transaction categories from durable Finta data only.\"\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 categories","description":"Returns stored transaction categories from durable Finta data only.","deprecated":null,"version":null,"openapi":"/api/v2/openapi.json get /categories","href":"/api-reference/categories/list-categories","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"List categories","description":"Returns stored transaction categories from durable Finta data only.","operationId":"listCategoriesV2","tags":["Categories"],"parameters":["7e2c53e0-b6eb-41ee-b852-e1fa83746b76","32e07666-eab3-4723-939a-56ee397563e4"],"responses":{"200":"aba63033-8983-40a0-801c-760166fa5115","400":"6e26668f-ce33-4980-b059-ae2bdb54e680","401":"647cd555-552c-4b94-b903-fa4829fca444","403":"101ff29d-ea3c-4767-8943-73ad5e4cd855","429":"bd8a7439-7d42-4ca3-8a9c-7f038c9a2027"},"method":"get","type":"path","servers":["0c23f4f7-1aab-4cf5-bc1a-4ed2407b6311"],"security":["1727483c-c96c-4f5e-8b2e-8832d482fd5b"],"path":"/categories","baseUrlOptions":["https://api.finta.io/v2"],"title":"List categories","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"7e2c53e0-b6eb-41ee-b852-e1fa83746b76":{"name":"provider","in":"query","required":false,"schema":{"type":"string","enum":["plaid","go_cardless","stripe","mercury"],"isRequired":false,"description":"Filter by data provider","uniqueKey":"","typeLabel":"enum\u003cstring>"},"description":"Filter by data provider"},"32e07666-eab3-4723-939a-56ee397563e4":{"name":"bankConnectionId","in":"query","required":false,"schema":{"type":"string","format":"uuid","isRequired":false,"description":"Filter to categories used by transactions on this bank connection","uniqueKey":"","typeLabel":"string\u003cuuid>"},"description":"Filter to categories used by transactions on this bank connection"}},"responses":{"aba63033-8983-40a0-801c-760166fa5115":{"description":"Categories for the authenticated user","content":{"application/json":{"schema":{"type":"object","required":["categories"],"properties":{"categories":{"type":"array","items":{"type":"object","required":["id","provider","providerId","name","group","categoryGroupId","description","type"],"properties":{"id":{"type":"string","format":"uuid","isRequired":true,"uniqueKey":"categories.items.[INDEX].id","typeLabel":"string\u003cuuid>"},"provider":{"type":"string","example":"plaid","isRequired":true,"uniqueKey":"categories.items.[INDEX].provider","typeLabel":"string"},"providerId":{"type":"string","isRequired":true,"uniqueKey":"categories.items.[INDEX].providerId","typeLabel":"string"},"name":{"type":"string","isRequired":true,"uniqueKey":"categories.items.[INDEX].name","typeLabel":"string"},"group":{"oneOf":[{"type":"string","description":"Name of the category group this category belongs to","isRequired":true,"uniqueKey":"categories.items.[INDEX].group.oneOf.0","typeLabel":"string"},{"type":"null","description":"Name of the category group this category belongs to","isRequired":true,"uniqueKey":"categories.items.[INDEX].group.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"categories.items.[INDEX].group","typeLabel":"string | null"},"categoryGroupId":{"oneOf":[{"type":"string","format":"uuid","description":"ID of the category group this category belongs to (see /category-groups)","isRequired":true,"uniqueKey":"categories.items.[INDEX].categoryGroupId.oneOf.0","typeLabel":"string\u003cuuid>"},{"type":"null","format":"uuid","description":"ID of the category group this category belongs to (see /category-groups)","isRequired":true,"uniqueKey":"categories.items.[INDEX].categoryGroupId.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"categories.items.[INDEX].categoryGroupId","typeLabel":"string\u003cuuid> | null"},"description":{"oneOf":[{"type":"string","isRequired":true,"uniqueKey":"categories.items.[INDEX].description.oneOf.0","typeLabel":"string"},{"type":"null","isRequired":true,"uniqueKey":"categories.items.[INDEX].description.oneOf.1","typeLabel":"null"}],"isRequired":true,"uniqueKey":"categories.items.[INDEX].description","typeLabel":"string | null"},"type":{"type":"string","enum":["income","expense","transfer"],"description":"Only expense categories count as spending and can be budgeted.","isRequired":true,"uniqueKey":"categories.items.[INDEX].type","typeLabel":"enum\u003cstring>"}},"uniqueKey":"categories.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"categories","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"categories":[{"id":"3c90c3cc-0d44-4b50-8888-8dd25736052a","provider":"plaid","providerId":"\u003cstring>","name":"\u003cstring>","group":"\u003cstring>","categoryGroupId":"3c90c3cc-0d44-4b50-8888-8dd25736052a","description":"\u003cstring>","type":"income"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"6e26668f-ce33-4980-b059-ae2bdb54e680":{"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"},"647cd555-552c-4b94-b903-fa4829fca444":{"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"},"101ff29d-ea3c-4767-8943-73ad5e4cd855":{"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"},"bd8a7439-7d42-4ca3-8a9c-7f038c9a2027":{"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 categories - Finta","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-03T05:00:02.800Z","originalFileLocation":"api-reference/categories/list-categories.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 transaction categories from durable Finta data only.\">\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 categories - Finta\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns stored transaction categories from durable Finta data only.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Finta\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.finta.io/api-reference/categories/list-categories\">\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=Categories\u0026amp;title=List+categories\u0026amp;description=Returns+stored+transaction+categories+from+durable+Finta+data+only.\u0026amp;theme=ce8291f76a2c0db9e1376b0f\u0026amp;signature=388cd4d644a9846a01f0fe4a66a430012b3d1c0349c742bad5d35f8d7cd1ee67\">\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 categories - Finta\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns stored transaction categories from durable Finta data only.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://finta-10.mintlify.app/_mintlify/api/og/v2?division=Categories\u0026amp;title=List+categories\u0026amp;description=Returns+stored+transaction+categories+from+durable+Finta+data+only.\u0026amp;theme=ce8291f76a2c0db9e1376b0f\u0026amp;signature=388cd4d644a9846a01f0fe4a66a430012b3d1c0349c742bad5d35f8d7cd1ee67\">\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/categories/list-categories\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/categories/list-categories.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/categories/list-categories#webpage\",\"url\":\"https://docs.finta.io/api-reference/categories/list-categories\",\"name\":\"List categories\",\"description\":\"Returns stored transaction categories from durable Finta data only.\",\"dateModified\":\"2026-11-03T05:00:02.800Z\",\"isPartOf\":{\"@id\":\"https://docs.finta.io#website\"},\"breadcrumb\":{\"@id\":\"https://docs.finta.io/api-reference/categories/list-categories#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.finta.io/api-reference/categories/list-categories#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Reference\",\"item\":\"https://docs.finta.io/api-reference/health/health-check\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"List categories\",\"item\":\"https://docs.finta.io/api-reference/categories/list-categories\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.finta.io/api-reference/categories/list-categories#apireference\",\"headline\":\"List categories\",\"name\":\"List categories\",\"description\":\"Returns stored transaction categories from durable Finta data only.\",\"url\":\"https://docs.finta.io/api-reference/categories/list-categories\",\"mainEntityOfPage\":{\"@id\":\"https://docs.finta.io/api-reference/categories/list-categories#webpage\"},\"dateModified\":\"2026-11-03T05:00:02.800Z\",\"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","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","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","description":"Update multiple transactions at once (max 250). Currently supports setting or clearing categoryId per transaction.","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","description":"Create a new manual 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 categories - Finta","buildId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","deploymentId":"dpl_36EDyZCDfRuoUD9af5CH4M1bqY2h","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-DCDCdBVX.js","utils-ME8dDnLe.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-0e84ACsd.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-wgRBj-ia.js","snippetPresets-C11Sgb-o.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","ApiExamples-C0lapOpP.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-ZeRQV8fF.js","shallow-BupWh095.js","getApiPlaygroundDisplay-BnYQO2Ss.js","CodeSnippet-RKKOc8c_.js","CodeSnippets-Drf_m8wS.js","Page-Bevw23-4.js","getPastedJson-u6QiPzNZ.js","icon-Bb-CBSxO.js","MethodPill-F7l5AI7V.js","DuplicateIcon-IiAXkdSg.js","createIcon-FliI8EBc.js","DynamicMarkdown-B62XqCSI.js","SectionHeading-Dj31pT03.js","axios-vUo_bRtp.js","Markdown-BOgQCTwD.js","clsx-BIWXJmsZ.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-DKZWslLH.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-UDqbR6xh.js"]}