> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dune.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Folder

> 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.

> [!NOTE]
>
> Minimum required API key scope: `Read`

# Use Cases

* **See Folder Contents**: Get the subfolders, queries, and dashboards inside a folder.
* **Check Before Deleting**: Confirm what a folder holds before you delete it.


## OpenAPI

````yaml GET /v1/folders/{folder_id}
openapi: 3.0.1
info:
  contact: {}
  description: Dune API
  title: DuneAPI
  version: '1.0'
servers:
  - url: https://api.dune.com/api
security: []
paths:
  /v1/folders/{folder_id}:
    get:
      summary: Get a 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.
      parameters:
        - description: API Key for the service
          in: header
          name: X-Dune-Api-Key
          required: true
          schema:
            type: string
        - description: API Key, alternative to using the HTTP header X-Dune-Api-Key
          in: query
          name: api_key
          schema:
            type: string
        - description: Folder id
          in: path
          name: folder_id
          required: true
          schema:
            type: string
        - description: Maximum number of items to return (default 50, max 100)
          in: query
          name: limit
          schema:
            type: integer
        - description: >-
            Number of results to skip. Use next_offset from the previous
            response
          in: query
          name: offset
          schema:
            type: integer
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.GetFolderResponse'
          description: OK
        '400':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.FolderError'
          description: Bad Request
        '401':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.Error401'
          description: Unauthorized
        '403':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.FolderError'
          description: Forbidden
        '404':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.FolderError'
          description: Not Found
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/models.Error500'
          description: Internal Server Error
components:
  schemas:
    models.GetFolderResponse:
      properties:
        folder:
          $ref: '#/components/schemas/models.Folder'
        has_more_subfolders:
          description: >-
            HasMoreSubfolders is true when there are more than 100 subfolders;
            page through them

            with GET /v1/folders?parent_folder_id=<folder_id>.
          type: boolean
        items:
          items:
            $ref: '#/components/schemas/models.FolderItem'
          type: array
        next_offset:
          description: >-
            NextOffset is set when more items exist; pass it as the offset query
            parameter.
          type: integer
        subfolders:
          items:
            $ref: '#/components/schemas/models.FolderSummary'
          type: array
        total_items:
          example: 2
          type: integer
      type: object
    models.FolderError:
      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
        details:
          allOf:
            - $ref: '#/components/schemas/models.FolderErrorDetails'
          description: >-
            Details carries the existing folder for folder_already_exists, and
            what a recursive delete

            would remove for folder_not_empty.
        error:
          example: Folder not found
          type: string
      type: object
    models.Error401:
      properties:
        error:
          example: Invalid API Key
          type: string
      type: object
    models.Error500:
      properties:
        error:
          example: Internal error
          type: string
      type: object
    models.Folder:
      properties:
        color:
          description: Color is a preset name or a hex value.
          example: blue
          type: string
        created_at:
          type: string
        description:
          type: string
        folder_id:
          example: dp180Cu3jW3L
          type: string
        icon:
          example: folder
          type: string
        name:
          example: RWA
          type: string
        parent_folder_id:
          description: ParentFolderID is null for a folder at the library root.
          example: aZ3kP0qLm9Xc
          type: string
        path:
          description: Path is the full path from the library root.
          example: /Research/RWA
          type: string
        updated_at:
          type: string
      type: object
    models.FolderItem:
      properties:
        id:
          description: ID is the query id or the dashboard id, depending on type.
          example: 4512345
          type: integer
        is_private:
          type: boolean
        name:
          example: RWA TVL by issuer
          type: string
        type:
          enum:
            - query
            - dashboard
          example: query
          type: string
        updated_at:
          type: string
      type: object
    models.FolderSummary:
      properties:
        folder_id:
          example: dp180Cu3jW3L
          type: string
        item_count:
          description: >-
            ItemCount counts the queries and dashboards directly inside the
            folder.
          example: 12
          type: integer
        name:
          example: RWA
          type: string
        path:
          example: /Research/RWA
          type: string
      type: object
    models.FolderErrorDetails:
      properties:
        dashboard_count:
          type: integer
        existing_folder_id:
          type: string
        query_count:
          type: integer
        subfolder_count:
          type: integer
      type: object

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.