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

# 폴더 목록 조회

> 비즈니스의 폴더(`Folder`) 목록을 조회합니다. **정렬:** `is_default=True`인 기본 폴더가 먼저, 그 다음 생성순 역순(`-created`).

**용도:** 의뢰 상태(InquiryStatus)가 폴더에 속하며, 의뢰 생성 시 폴더는 status를 통해 간접 지정됩니다. 기본 폴더는 시스템상 1개 보장되며 삭제 불가입니다.

**filter:** `OpenapiFolderFilter` 사용 가능.



## OpenAPI

````yaml GET /v1/folder
openapi: 3.1.0
info:
  title: pluuug openapi
  version: 1.0.0
  description: >-
    플러그에서 제공하는 REST API의 상세 내용을 확인하고 직접 테스트할 수 있는 인터페이스입니다.<br>이 문서를 통해 API의
    엔드포인트, 요청 및 응답 형식 등을 확인할 수 있습니다.
servers:
  - url: https://openapi.pluuug.com
security: []
paths:
  /v1/folder:
    get:
      tags:
        - folder
      summary: 폴더 목록
      description: >-
        비즈니스의 폴더(`Folder`) 목록을 조회합니다. **정렬:** `is_default=True`인 기본 폴더가 먼저, 그 다음
        생성순 역순(`-created`).


        **용도:** 의뢰 상태(InquiryStatus)가 폴더에 속하며, 의뢰 생성 시 폴더는 status를 통해 간접 지정됩니다.
        기본 폴더는 시스템상 1개 보장되며 삭제 불가입니다.


        **filter:** `OpenapiFolderFilter` 사용 가능.
      operationId: folder_list
      parameters:
        - in: query
          name: search
          schema:
            type: string
      responses:
        '200':
          content:
            application/json:
              schema:
                type: array
                items:
                  $ref: '#/components/schemas/OpenapiFolder'
          description: ''
      security:
        - ApiKeyAuth: []
          Signature: []
components:
  schemas:
    OpenapiFolder:
      type: object
      properties:
        id:
          type: integer
          readOnly: true
        name:
          type: string
          readOnly: true
          description: 폴더 이름
        isDefault:
          type: boolean
          readOnly: true
          description: 기본 폴더 여부
      required:
        - id
        - isDefault
        - name
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
    Signature:
      type: apiKey
      in: header
      name: X-Signature
      description: |-
        HMAC-SHA256 방식으로 body를 secret key로 해싱하여 생성한 서명을 넣어야 합니다.
        서버는 X-API-Key와 대응되는 secret key로 서명을 검증합니다.

````