Get a folder, its direct subfolders, and the queries and dashboards directly inside it that are not archived, ordered by name. Page through the items with limit and next_offset.
GET
/
v1
/
folders
/
{folder_id}
Get a folder
curl --request GET \ --url https://api.dune.com/api/v1/folders/{folder_id} \ --header 'X-Dune-Api-Key: <x-dune-api-key>'
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Dune Docs","description":"Official documentation for building with Dune's data platform, query engine, and API.","colors":{"primary":"#0f0f15","light":"#ffffff","dark":"#0f0f15"},"logo":{"light":"https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max\u0026auto=format\u0026n=zh-3B8LgVmyrKOaG\u0026q=85\u0026s=6fec71d5070d0923eb2924321131b1c2","dark":"https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-dark.svg?fit=max\u0026auto=format\u0026n=zh-3B8LgVmyrKOaG\u0026q=85\u0026s=2501750983cc95aa72d40acc6f005bd9","href":"https://docs.dune.com/"},"navbar":{"links":[{"href":"mailto:support@dune.com","label":"Support"}],"primary":{"type":"button","label":"Start building","href":"https://dune.com"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/dune-analytics","github":"https://github.com/duneanalytics","x":"https://x.com/dune","telegram":"https://t.me/dune_updates","youtube":"https://www.youtube.com/@dunecom"}},"seo":{"metatags":{"title":"Dune Docs","description":"Official documentation for building with Dune's data platform, query engine, and API.","og:site_name":"Dune Docs","twitter:card":"summary_large_image"},"indexing":"navigable"},"fonts":{"family":"Geist"},"integrations":{"amplitude":{"apiKey":"e76ce253e6eaa36e3be8e6872101e33a"},"ga4":{"measurementId":"G-H1G057R0KN"},"gtm":{"tagId":"GTM-P46XP3Z5"}},"contextual":{"options":["chatgpt","claude","copy","view"],"display":"header"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"dune","hasAudioNarration":false,"actualSubdomain":"dune","customDomains":["docs.dune.com"],"gitSource":{"type":"github","owner":"duneanalytics","repo":"dune-docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true,"issues":true},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af1ea8734be7c1d8321e1b4","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"Data Catalog","count":1405},{"language":"default","tag":"EVM Networks","count":895},{"language":"default","tag":"Decoded","count":373},{"language":"default","tag":"Raw","count":326},{"language":"default","tag":"Non-EVM Networks","count":270},{"language":"default","tag":"Curated Data","count":156},{"language":"default","tag":"Curated","count":129},{"language":"default","tag":"DEX","count":89},{"language":"default","tag":"API Reference","count":75},{"language":"default","tag":"THORChain","count":72}]},"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":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"styles.css","content":"#topbar-cta-button>a>span,#navigation-items .sidebar-group>li>a,#sidebar-group>li>a,#search-bar-entry,.chat-assistant-floating-input>div{border-radius:9999px}.dark #topbar-cta-button>a>span{background-color:#fff}.dark #topbar-cta-button>a>span+div>span{color:#0f0f15}.dark #topbar-cta-button>a>span+div>svg{color:#0f0f15}#page-context-menu>button:first-child{border-top-left-radius:9999px;border-bottom-left-radius:9999px}#page-context-menu>button:last-child{border-top-right-radius:9999px;border-bottom-right-radius:9999px}.cta-links a,.cta-links a:visited,.cta-links a:hover,.cta-links a:active,aside a,.note-container a,[class*=\"note\"] a,[class*=\"Note\"] a,[class*=\"callout\"] a,div[class*=\"admonition\"] a,div[role=\"note\"] a{text-decoration-color:white!important;text-decoration-thickness:2px!important;text-decoration-line:underline!important}table a{text-decoration:underline!important;text-underline-offset:2px;transition:opacity 0.2s ease}table a:hover{opacity:0.7}"}],"page":{"pagePath":"api-reference/folders/endpoint/get","slug":"/api-reference/folders/endpoint/get","pageMetadata":{"title":"Get Folder","openapi":"GET /v1/folders/{folder_id}","description":"Get a folder, its direct subfolders, and the queries and dashboards directly inside it that are not archived, ordered by name. Page through the items with limit and next_offset.","href":"/api-reference/folders/endpoint/get"},"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: \"Get a folder, its direct subfolders, and the queries and dashboards directly inside it that are not archived, ordered by name. Page through the items with limit and next_offset.\"\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,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={code:`code`,li:`li`,p:`p`,strong:`strong`,ul:`ul`,..._provideComponents(),...props.components},{Heading,Info}=_components;if(!Heading)_missingMdxReference(`Heading`,true);if(!Info)_missingMdxReference(`Info`,true);return _jsxs(_Fragment,{children:[_jsx(Info,{children:_jsxs(_components.p,{children:[`Minimum required API key scope: `,_jsx(_components.code,{children:`Read`})]})}),`\n`,_jsx(Heading,{level:`1`,id:`use-cases`,children:`Use Cases`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`See Folder Contents`}),`: Get the subfolders, queries, and dashboards inside a folder.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Check Before Deleting`}),`: Confirm what a folder holds before you delete it.`]}),`\n`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Get Folder","openapi":"GET /v1/folders/{folder_id}","description":"Get a folder, its direct subfolders, and the queries and dashboards directly inside it that are not archived, ordered by name. Page through the items with limit and next_offset.","href":"/api-reference/folders/endpoint/get"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"Use Cases","slug":"use-cases","depth":1,"children":[]}],"codeExamples":{}},"jsLinks":["/_mintlify/custom/dune/3dc9988ffc23fc85/favicon-switcher.js","/_mintlify/custom/dune/11037b9cc10a9f51/amplitude.js"],"openApiReferenceData":{"operation":{"description":"Get a folder, its direct subfolders, and the queries and dashboards directly inside it that are not archived, ordered by name. Page through the items with limit and next_offset.","parameters":["f07cd19c-6820-49d2-8a89-f42e2f5d28f4","7f3a9075-7dfd-47a3-84dd-e05d88fd9c81","407f06f5-7cdb-4860-adcd-395aa66ae910","08d9d9a0-e90b-499e-8e51-f48898067539","752ae9ff-e500-4b88-b8e9-ea1e9355708b"],"responses":{"200":"e8242fd1-34b2-44fe-898c-bb4aca0c7435","400":"015ebc34-8f07-47bc-a62a-699ad97d8912","401":"8d3700a9-470f-4ace-b369-f61b98b3b3f1","403":"3b4ce8f6-0c70-4787-8c26-92faa7e43bd4","404":"cfc1224f-8b6d-429f-8f17-6bbf550fdd4d","500":"be2df1fe-76d8-40bc-8a85-b83fbf5f5c93"},"summary":"Get a folder","x-required-scope":"Read","method":"get","type":"path","servers":["7ce6c8f5-fef4-4812-83e6-0befd070d5cc"],"security":[],"path":"/v1/folders/{folder_id}","baseUrlOptions":["https://api.dune.com/api"],"title":"Get a folder","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{"f07cd19c-6820-49d2-8a89-f42e2f5d28f4":{"description":"API Key for the service","in":"header","name":"X-Dune-Api-Key","required":true,"schema":{"type":"string","isRequired":true,"description":"API Key for the service","uniqueKey":"","typeLabel":"string"}},"7f3a9075-7dfd-47a3-84dd-e05d88fd9c81":{"description":"API Key, alternative to using the HTTP header X-Dune-Api-Key","in":"query","name":"api_key","schema":{"type":"string","description":"API Key, alternative to using the HTTP header X-Dune-Api-Key","uniqueKey":"","typeLabel":"string"}},"407f06f5-7cdb-4860-adcd-395aa66ae910":{"description":"Folder id","in":"path","name":"folder_id","required":true,"schema":{"type":"string","isRequired":true,"description":"Folder id","uniqueKey":"","typeLabel":"string"}},"08d9d9a0-e90b-499e-8e51-f48898067539":{"description":"Maximum number of items to return (default 50, max 100)","in":"query","name":"limit","schema":{"type":"integer","description":"Maximum number of items to return (default 50, max 100)","uniqueKey":"","typeLabel":"integer"}},"752ae9ff-e500-4b88-b8e9-ea1e9355708b":{"description":"Number of results to skip. Use next_offset from the previous response","in":"query","name":"offset","schema":{"type":"integer","description":"Number of results to skip. Use next_offset from the previous response","uniqueKey":"","typeLabel":"integer"}}},"responses":{"e8242fd1-34b2-44fe-898c-bb4aca0c7435":{"content":{"application/json":{"schema":{"properties":{"folder":{"properties":{"color":{"description":"Color is a preset name or a hex value.","example":"blue","type":"string","uniqueKey":"folder.color","typeLabel":"string"},"created_at":{"type":"string","uniqueKey":"folder.created_at","typeLabel":"string"},"description":{"type":"string","uniqueKey":"folder.description","typeLabel":"string"},"folder_id":{"example":"dp180Cu3jW3L","type":"string","uniqueKey":"folder.folder_id","typeLabel":"string"},"icon":{"example":"folder","type":"string","uniqueKey":"folder.icon","typeLabel":"string"},"name":{"example":"RWA","type":"string","uniqueKey":"folder.name","typeLabel":"string"},"parent_folder_id":{"description":"ParentFolderID is null for a folder at the library root.","example":"aZ3kP0qLm9Xc","type":"string","uniqueKey":"folder.parent_folder_id","typeLabel":"string"},"path":{"description":"Path is the full path from the library root.","example":"/Research/RWA","type":"string","uniqueKey":"folder.path","typeLabel":"string"},"updated_at":{"type":"string","uniqueKey":"folder.updated_at","typeLabel":"string"}},"type":"object","uniqueKey":"folder","typeLabel":"object"},"has_more_subfolders":{"description":"HasMoreSubfolders is true when there are more than 100 subfolders; page through them\nwith GET /v1/folders?parent_folder_id=\u003cfolder_id>.","type":"boolean","uniqueKey":"has_more_subfolders","typeLabel":"boolean"},"items":{"items":{"properties":{"id":{"description":"ID is the query id or the dashboard id, depending on type.","example":4512345,"type":"integer","uniqueKey":"\\items.items.[INDEX].id","typeLabel":"integer"},"is_private":{"type":"boolean","uniqueKey":"\\items.items.[INDEX].is_private","typeLabel":"boolean"},"name":{"example":"RWA TVL by issuer","type":"string","uniqueKey":"\\items.items.[INDEX].name","typeLabel":"string"},"type":{"enum":["query","dashboard"],"example":"query","type":"string","uniqueKey":"\\items.items.[INDEX].type","typeLabel":"enum\u003cstring>"},"updated_at":{"type":"string","uniqueKey":"\\items.items.[INDEX].updated_at","typeLabel":"string"}},"type":"object","uniqueKey":"\\items.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"\\items","typeLabel":"object[]"},"next_offset":{"description":"NextOffset is set when more items exist; pass it as the offset query parameter.","type":"integer","uniqueKey":"next_offset","typeLabel":"integer"},"subfolders":{"items":{"properties":{"folder_id":{"example":"dp180Cu3jW3L","type":"string","uniqueKey":"subfolders.items.[INDEX].folder_id","typeLabel":"string"},"item_count":{"description":"ItemCount counts the queries and dashboards directly inside the folder.","example":12,"type":"integer","uniqueKey":"subfolders.items.[INDEX].item_count","typeLabel":"integer"},"name":{"example":"RWA","type":"string","uniqueKey":"subfolders.items.[INDEX].name","typeLabel":"string"},"path":{"example":"/Research/RWA","type":"string","uniqueKey":"subfolders.items.[INDEX].path","typeLabel":"string"}},"type":"object","uniqueKey":"subfolders.items.[INDEX]","typeLabel":"object"},"type":"array","uniqueKey":"subfolders","typeLabel":"object[]"},"total_items":{"example":2,"type":"integer","uniqueKey":"total_items","typeLabel":"integer"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"folder":{"color":"blue","created_at":"\u003cstring>","description":"\u003cstring>","folder_id":"dp180Cu3jW3L","icon":"folder","name":"RWA","parent_folder_id":"aZ3kP0qLm9Xc","path":"/Research/RWA","updated_at":"\u003cstring>"},"has_more_subfolders":true,"items":[{"id":4512345,"is_private":true,"name":"RWA TVL by issuer","type":"query","updated_at":"\u003cstring>"}],"next_offset":123,"subfolders":[{"folder_id":"dp180Cu3jW3L","item_count":12,"name":"RWA","path":"/Research/RWA"}],"total_items":2}}},"exampleType":"generated"}},"description":"OK","exampleType":"generated"},"015ebc34-8f07-47bc-a62a-699ad97d8912":{"content":{"application/json":{"schema":{"properties":{"code":{"enum":["invalid_argument","folder_not_found","content_not_found","folder_already_exists","folder_not_empty","invalid_move","not_authorized","no_acting_user","folder_quota_reached","unimplemented"],"example":"folder_not_found","type":"string","uniqueKey":"code","typeLabel":"enum\u003cstring>"},"details":{"type":"object","description":"Details carries the existing folder for folder_already_exists, and what a recursive delete\nwould remove for folder_not_empty.","properties":{"dashboard_count":{"type":"integer","uniqueKey":"details.dashboard_count","typeLabel":"integer"},"existing_folder_id":{"type":"string","uniqueKey":"details.existing_folder_id","typeLabel":"string"},"query_count":{"type":"integer","uniqueKey":"details.query_count","typeLabel":"integer"},"subfolder_count":{"type":"integer","uniqueKey":"details.subfolder_count","typeLabel":"integer"}},"uniqueKey":"details","typeLabel":"object"},"error":{"example":"Folder not found","type":"string","uniqueKey":"error","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"folder_not_found","details":{"dashboard_count":123,"existing_folder_id":"\u003cstring>","query_count":123,"subfolder_count":123},"error":"Folder not found"}}},"exampleType":"generated"}},"description":"Bad Request","exampleType":"generated"},"8d3700a9-470f-4ace-b369-f61b98b3b3f1":{"content":{"application/json":{"schema":{"properties":{"error":{"example":"Invalid API Key","type":"string","uniqueKey":"error","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Invalid API Key"}}},"exampleType":"generated"}},"description":"Unauthorized","exampleType":"generated"},"3b4ce8f6-0c70-4787-8c26-92faa7e43bd4":{"content":{"application/json":{"schema":{"properties":{"code":{"enum":["invalid_argument","folder_not_found","content_not_found","folder_already_exists","folder_not_empty","invalid_move","not_authorized","no_acting_user","folder_quota_reached","unimplemented"],"example":"folder_not_found","type":"string","uniqueKey":"code","typeLabel":"enum\u003cstring>"},"details":{"type":"object","description":"Details carries the existing folder for folder_already_exists, and what a recursive delete\nwould remove for folder_not_empty.","properties":{"dashboard_count":{"type":"integer","uniqueKey":"details.dashboard_count","typeLabel":"integer"},"existing_folder_id":{"type":"string","uniqueKey":"details.existing_folder_id","typeLabel":"string"},"query_count":{"type":"integer","uniqueKey":"details.query_count","typeLabel":"integer"},"subfolder_count":{"type":"integer","uniqueKey":"details.subfolder_count","typeLabel":"integer"}},"uniqueKey":"details","typeLabel":"object"},"error":{"example":"Folder not found","type":"string","uniqueKey":"error","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"folder_not_found","details":{"dashboard_count":123,"existing_folder_id":"\u003cstring>","query_count":123,"subfolder_count":123},"error":"Folder not found"}}},"exampleType":"generated"}},"description":"Forbidden","exampleType":"generated"},"cfc1224f-8b6d-429f-8f17-6bbf550fdd4d":{"content":{"application/json":{"schema":{"properties":{"code":{"enum":["invalid_argument","folder_not_found","content_not_found","folder_already_exists","folder_not_empty","invalid_move","not_authorized","no_acting_user","folder_quota_reached","unimplemented"],"example":"folder_not_found","type":"string","uniqueKey":"code","typeLabel":"enum\u003cstring>"},"details":{"type":"object","description":"Details carries the existing folder for folder_already_exists, and what a recursive delete\nwould remove for folder_not_empty.","properties":{"dashboard_count":{"type":"integer","uniqueKey":"details.dashboard_count","typeLabel":"integer"},"existing_folder_id":{"type":"string","uniqueKey":"details.existing_folder_id","typeLabel":"string"},"query_count":{"type":"integer","uniqueKey":"details.query_count","typeLabel":"integer"},"subfolder_count":{"type":"integer","uniqueKey":"details.subfolder_count","typeLabel":"integer"}},"uniqueKey":"details","typeLabel":"object"},"error":{"example":"Folder not found","type":"string","uniqueKey":"error","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"code":"folder_not_found","details":{"dashboard_count":123,"existing_folder_id":"\u003cstring>","query_count":123,"subfolder_count":123},"error":"Folder not found"}}},"exampleType":"generated"}},"description":"Not Found","exampleType":"generated"},"be2df1fe-76d8-40bc-8a85-b83fbf5f5c93":{"content":{"application/json":{"schema":{"properties":{"error":{"example":"Internal error","type":"string","uniqueKey":"error","typeLabel":"string"}},"type":"object","uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"error":"Internal error"}}},"exampleType":"generated"}},"description":"Internal Server Error","exampleType":"generated"}},"security":{},"servers":{"7ce6c8f5-fef4-4812-83e6-0befd070d5cc":{"url":"https://api.dune.com/api"}}},"originalFileLocation":"analytics-openapi.json"},"subdomain":"dune","siteName":"Dune Docs","title":"Get Folder - Dune Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-09T15:16:42.586Z","originalFileLocation":"api-reference/folders/endpoint/get.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=\"Get a folder, its direct subfolders, and the queries and dashboards directly inside it that are not archived, ordered by name. Page through the items with limit and next_offset.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Dune Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/dune/_generated/favicon/apple-touch-icon.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/dune/_generated/favicon/favicon-32x32.png?v=3\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/dune/_generated/favicon/favicon-16x16.png?v=3\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"https://mintlify.s3.us-west-1.amazonaws.com/dune/_generated/favicon/favicon.ico?v=3\">\u003cmeta data-mint-head property=\"og:title\" content=\"Get Folder - Dune Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Get a folder, its direct subfolders, and the queries and dashboards directly inside it that are not archived, ordered by name. Page through the items with limit and next_offset.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Dune Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.dune.com/api-reference/folders/endpoint/get\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://dune.mintlify.site/_mintlify/api/og/v2?division=Folders\u0026amp;title=Get+Folder\u0026amp;description=Get+a+folder%2C+its+direct+subfolders%2C+and+the+queries+and+dashboards+directly+inside+it+that+are+not+archived%2C+ordered+by+name.+Page+through+the+items+with+limit\u0026amp;theme=d9c0cb23e9b44d10ee46351c\u0026amp;signature=83f5914470bd5e50615b96233a9a5729eae1bbff2b66b58aff1712fdfc19d325\">\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=\"Get Folder - Dune Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Get a folder, its direct subfolders, and the queries and dashboards directly inside it that are not archived, ordered by name. Page through the items with limit and next_offset.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://dune.mintlify.site/_mintlify/api/og/v2?division=Folders\u0026amp;title=Get+Folder\u0026amp;description=Get+a+folder%2C+its+direct+subfolders%2C+and+the+queries+and+dashboards+directly+inside+it+that+are+not+archived%2C+ordered+by+name.+Page+through+the+items+with+limit\u0026amp;theme=d9c0cb23e9b44d10ee46351c\u0026amp;signature=83f5914470bd5e50615b96233a9a5729eae1bbff2b66b58aff1712fdfc19d325\">\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=\"https://mintlify.s3.us-west-1.amazonaws.com/dune/_generated/favicon/browserconfig.xml?v=3\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Dune Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0f0f15\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.dune.com/api-reference/folders/endpoint/get\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/folders/endpoint/get.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.dune.com/#organization\",\"name\":\"Dune Docs\",\"url\":\"https://docs.dune.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/dune/zh-3B8LgVmyrKOaG/logo/dune-logo-light.svg?fit=max\u0026auto=format\u0026n=zh-3B8LgVmyrKOaG\u0026q=85\u0026s=6fec71d5070d0923eb2924321131b1c2\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.dune.com#website\",\"name\":\"Dune Docs\",\"url\":\"https://docs.dune.com\",\"publisher\":{\"@id\":\"https://docs.dune.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.dune.com/api-reference/folders/endpoint/get#webpage\",\"url\":\"https://docs.dune.com/api-reference/folders/endpoint/get\",\"name\":\"Get Folder\",\"description\":\"Get a folder, its direct subfolders, and the queries and dashboards directly inside it that are not archived, ordered by name. Page through the items with limit and next_offset.\",\"dateModified\":\"2026-11-09T15:16:42.586Z\",\"isPartOf\":{\"@id\":\"https://docs.dune.com#website\"},\"breadcrumb\":{\"@id\":\"https://docs.dune.com/api-reference/folders/endpoint/get#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.dune.com/api-reference/folders/endpoint/get#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Folders\",\"item\":\"https://docs.dune.com/api-reference/folders/introduction\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Get Folder\",\"item\":\"https://docs.dune.com/api-reference/folders/endpoint/get\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.dune.com/api-reference/folders/endpoint/get#apireference\",\"headline\":\"Get Folder\",\"name\":\"Get Folder\",\"description\":\"Get a folder, its direct subfolders, and the queries and dashboards directly inside it that are not archived, ordered by name. Page through the items with limit and next_offset.\",\"url\":\"https://docs.dune.com/api-reference/folders/endpoint/get\",\"mainEntityOfPage\":{\"@id\":\"https://docs.dune.com/api-reference/folders/endpoint/get#webpage\"},\"dateModified\":\"2026-11-09T15:16:42.586Z\",\"publisher\":{\"@id\":\"https://docs.dune.com/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.dune.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Dune Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Dune Docs","nav":{"global":null,"tabs":[{"tab":"Docs","pages":[{"title":"Docs","href":""}]},{"tab":"Data Catalog","pages":[{"title":"Data Catalog","href":"/data-catalog/overview"}]},{"tab":"API Reference","pages":[{"group":"Introduction","pages":[{"title":"Overview","icon":"connectdevelop","href":"/api-reference/overview/introduction"},{"title":"Getting Started","icon":"flag-checkered","href":"/api-reference/overview/getting-started"},{"title":"Authentication","icon":"user","href":"/api-reference/overview/authentication"},{"title":"Troubleshooting Errors","icon":"square-question","href":"/api-reference/overview/troubleshooting"}]},{"group":"Quick Start","pages":[{"title":"Analyze Onchain Data","icon":"chart-line","href":"/api-reference/apis/quickstart-analyze"},{"title":"Build Custom Dashboards \u0026 Reports","icon":"desktop","href":"/api-reference/apis/quickstart-dashboards"}]},{"group":"Executions and Results","pages":[{"title":"Overview","icon":"star","href":"/api-reference/executions/execution-object"},{"title":"Execute SQL","openapi":"POST /v1/sql/execute","href":"/api-reference/executions/endpoint/execute-sql"},{"title":"Execute Query","openapi":"POST /v1/query/{query_id}/execute","href":"/api-reference/executions/endpoint/execute-query"},{"title":"Execute Query Pipeline","openapi":"POST /v1/query/{query_id}/pipeline/execute","href":"/api-reference/executions/endpoint/execute-query-pipeline"},{"title":"Get Execution Status","openapi":"GET /v1/execution/{execution_id}/status","href":"/api-reference/executions/endpoint/get-execution-status"},{"title":"Get Execution Result","openapi":"GET /v1/execution/{execution_id}/results","href":"/api-reference/executions/endpoint/get-execution-result"},{"title":"Get Execution Result in CSV","openapi":"GET /v1/execution/{execution_id}/results/csv","href":"/api-reference/executions/endpoint/get-execution-result-csv"},{"title":"Get Latest Query Result","openapi":"GET /v1/query/{query_id}/results","href":"/api-reference/executions/endpoint/get-query-result"},{"title":"Get Latest Query Result in CSV","openapi":"GET /v1/query/{query_id}/results/csv","href":"/api-reference/executions/endpoint/get-query-result-csv"},{"title":"Cancel Execution","openapi":"POST /v1/execution/{execution_id}/cancel","href":"/api-reference/executions/endpoint/cancel-execution"}]},{"group":"Query Management","pages":[{"title":"Overview","icon":"star","href":"/api-reference/queries/endpoint/query-object"},{"title":"List Queries","openapi":"GET /v1/queries","href":"/api-reference/queries/endpoint/list"},{"title":"Get Query Pipeline","openapi":"GET /v1/query/{query_id}/pipeline","href":"/api-reference/queries/endpoint/get-query-pipeline"},{"title":"Create Query","openapi":"POST /v1/query","href":"/api-reference/queries/endpoint/create"},{"title":"Update Query","openapi":"PATCH /v1/query/{queryId}","href":"/api-reference/queries/endpoint/update"},{"title":"Read Query","openapi":"GET /v1/query/{queryId}","href":"/api-reference/queries/endpoint/read"},{"title":"Archive Query","openapi":"POST /v1/query/{queryId}/archive","href":"/api-reference/queries/endpoint/archive"},{"title":"Unarchive Query","openapi":"POST /v1/query/{queryId}/unarchive","href":"/api-reference/queries/endpoint/unarchive"},{"title":"Private Query","openapi":"POST /v1/query/{queryId}/private","href":"/api-reference/queries/endpoint/private"},{"title":"Unprivate Query","openapi":"POST /v1/query/{queryId}/unprivate","href":"/api-reference/queries/endpoint/unprivate"}]},{"group":"Folders","pages":[{"title":"Overview","icon":"folder","href":"/api-reference/folders/introduction"},{"title":"List Folders","openapi":"GET /v1/folders","description":"List the folders directly inside a folder, or at the root of the library, ordered by name. A team API key works on the team's folders as the team member who created the key; a personal key works on the user's own folders. Page with limit and the next_offset returned by the previous response.","href":"/api-reference/folders/endpoint/list"},{"title":"Get Folder","openapi":"GET /v1/folders/{folder_id}","href":"/api-reference/folders/endpoint/get"},{"title":"Create Folder","openapi":"POST /v1/folders","description":"Create a folder at the root of the library or inside parent_folder_id. Team folders need an editor or admin behind the API key. When a folder already exists at the same path the response is 409 with code folder_already_exists and details.existing_folder_id, so a retry can use that folder.","href":"/api-reference/folders/endpoint/create"},{"title":"Update Folder","openapi":"PATCH /v1/folders/{folder_id}","href":"/api-reference/folders/endpoint/update"},{"title":"Move Folder","openapi":"POST /v1/folders/{folder_id}/move","href":"/api-reference/folders/endpoint/move"},{"title":"Delete Folder","openapi":"DELETE /v1/folders/{folder_id}","href":"/api-reference/folders/endpoint/delete"},{"title":"Move Queries and Dashboards","openapi":"POST /v1/content/move","href":"/api-reference/folders/endpoint/move-content"}]},{"group":"Schedules","pages":[{"title":"Overview","icon":"clock","href":"/api-reference/schedules/introduction"},{"title":"List Schedules","openapi":"GET /v1/schedules","href":"/api-reference/schedules/endpoint/list"},{"title":"Set Query Schedule","openapi":"PUT /v1/queries/{query_id}/schedule","href":"/api-reference/schedules/endpoint/set-query"},{"title":"Delete Query Schedule","openapi":"DELETE /v1/queries/{query_id}/schedule","href":"/api-reference/schedules/endpoint/delete-query"},{"title":"Set Dashboard Schedule","openapi":"PUT /v1/dashboards/{dashboard_id}/schedule","href":"/api-reference/schedules/endpoint/set-dashboard"},{"title":"Delete Dashboard Schedule","openapi":"DELETE /v1/dashboards/{dashboard_id}/schedule","href":"/api-reference/schedules/endpoint/delete-dashboard"}]},{"group":"Data Uploads","pages":[{"title":"Overview","icon":"star","href":"/api-reference/tables/endpoint/overview"},{"title":"List Uploaded Tables","openapi":"GET /v1/uploads","href":"/api-reference/tables/endpoint/uploads-list"},{"title":"Create Table","openapi":"POST /v1/uploads","href":"/api-reference/tables/endpoint/uploads-create"},{"title":"Insert Data","openapi":"POST /v1/uploads/{namespace}/{table_name}/insert","href":"/api-reference/tables/endpoint/uploads-insert"},{"title":"Upload CSV","openapi":"POST /v1/uploads/csv","href":"/api-reference/tables/endpoint/uploads-csv"},{"title":"Clear Data","openapi":"POST /v1/uploads/{namespace}/{table_name}/clear","href":"/api-reference/tables/endpoint/uploads-clear"},{"title":"Delete Table","openapi":"DELETE /v1/uploads/{namespace}/{table_name}","href":"/api-reference/tables/endpoint/uploads-delete"},{"title":"Migration Guide","icon":"arrow-right","href":"/api-reference/tables/endpoint/migration"}]},{"group":"Datasets","pages":[{"title":"Overview","icon":"star","href":"/api-reference/datasets/introduction"},{"title":"List Datasets","openapi":"GET /v1/datasets","href":"/api-reference/datasets/endpoint/list"},{"title":"Get Dataset","openapi":"GET /v1/datasets/{slug}","href":"/api-reference/datasets/endpoint/get"},{"title":"Search Datasets","openapi":"POST /v1/datasets/search","href":"/api-reference/datasets/endpoint/search"},{"title":"Search Datasets by Contract Address","openapi":"POST /v1/datasets/search-by-contract","href":"/api-reference/datasets/endpoint/search-by-contract"}]},{"group":"Contract Decoding","pages":[{"title":"Overview","icon":"star","href":"/api-reference/contracts/introduction"},{"title":"Submit Contracts for Decoding","openapi":"POST /v1/contracts/decode","href":"/api-reference/contracts/endpoint/decode"},{"title":"List Contract Submissions","openapi":"GET /v1/contracts/submissions","href":"/api-reference/contracts/endpoint/list"}]},{"group":"Materialized Views","pages":[{"title":"Overview","icon":"star","href":"/api-reference/materialized-views/overview"},{"title":"Get Materialized View","openapi":"GET /v1/materialized-views/{name}","href":"/api-reference/materialized-views/get"},{"title":"Upsert Materialized View","openapi":"POST /v1/materialized-views","href":"/api-reference/materialized-views/create"},{"title":"Delete Materialized View","openapi":"DELETE /v1/materialized-views/{name}","href":"/api-reference/materialized-views/delete"},{"title":"List Materialized Views","openapi":"GET /v1/materialized-views","href":"/api-reference/materialized-views/list"},{"title":"Refresh Materialized View","openapi":"POST /v1/materialized-views/{name}/refresh","href":"/api-reference/materialized-views/refresh"}]},{"group":"Pipelines","pages":[{"title":"Overview","icon":"star","href":"/api-reference/pipelines/overview"},{"title":"Execute Pipeline","openapi":"POST /v1/pipelines/execute","href":"/api-reference/pipelines/endpoint/execute-pipeline"},{"title":"Get Pipeline Execution Status","openapi":"GET /v1/pipelines/executions/{pipeline_execution_id}/status","href":"/api-reference/pipelines/endpoint/get-pipeline-status"}]},{"group":"Account Management","pages":[{"title":"Overview","icon":"star","href":"/api-reference/usage/overview"},{"title":"Get Usage","openapi":"POST /v1/usage","href":"/api-reference/usage/endpoint/get-usage"}]},{"group":"Post-processing","pages":[{"title":"Result Filtering","icon":"filter","href":"/api-reference/executions/filtering"},{"title":"Pagination","icon":"list-ol","href":"/api-reference/executions/pagination"},{"title":"Sorting","icon":"arrow-down-arrow-up","href":"/api-reference/executions/sorting"},{"title":"Sampling","icon":"dice","href":"/api-reference/executions/sampling"}]},{"group":"Webhooks","pages":[{"title":"Create Webhook","icon":"webhook","iconType":"solid","href":"/api-reference/webhooks/webhook"}]},{"group":"Client SDKs","pages":[{"group":"Quickstart","pages":[{"title":"Execution \u0026 Results","href":"/api-reference/quickstart/results-eg"},{"title":"Query Management","href":"/api-reference/quickstart/queries-eg"},{"title":"Tables Management","href":"/api-reference/quickstart/tables-eg"}]},{"title":"Python","icon":"python","href":"/api-reference/sdks/python"},{"title":"TypeScript","icon":"js","href":"/api-reference/sdks/typescript"},{"title":"Go","icon":"golang","href":"/api-reference/sdks/go"}]},{"group":"Resources","pages":[{"title":"Rate Limits","icon":"wave-pulse","href":"/api-reference/overview/rate-limits"},{"title":"Billing","icon":"file-invoice-dollar","href":"/api-reference/overview/billing"},{"title":"FAQ","icon":"message-question","href":"/api-reference/overview/faq"}]}]},{"tab":"SQL Query Engine","pages":[{"title":"SQL Query Engine","href":"/query-engine/overview"}]},{"tab":"Resources","pages":[{"title":"Resources","href":"/resources/credits-billing/overview"}]}]},"basePath":"","title":"Get Folder - Dune Docs","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}