---
title: "최상위 카테고리(디렉토리) 조회"
method: GET
path: "/api/v1/categories"
tags: ["카테고리"]
---

# 최상위 카테고리(디렉토리) 조회

`GET /api/v1/categories`

유형별 최상위(ROOT) 카테고리를 조회합니다.

### 유형
- FURNITURE : 가구
- FURNITURE_SET : 가구 세트
- FINISH : 재질
- TEXTURE : 질감
- PROJECT : 프로젝트
- USER : 사용자
- COMPONENT : 부품
- PARAMETRIC_SALE : 파라메트릭 상품
- FILE : 파일

## Query parameters

- `categoryType` 'FURNITURE' | 'FURNITURE_SET' | 'FINISH' | 'TEXTURE' | 'PROJECT' | 'USER' | 'COMPONENT' | 'PARAMETRIC_SALE' | 'FILE', required — 카테고리 타입

## Response `200`

모든 응답은 200으로 내려갑니다 (성공 실패 포함) (장애상황에서만 5xx 노출)

- ApiResponseCategoryResponse
  - `result` 'SUCCESS' | 'FAIL', required — 응답 결과 타입
  - `data` CategoryResponse
    - `id` string, required — 카테고리 ID
    - `parentId` string — 상위 카테고리 ID
    - `name` string, required — 카테고리 이름
    - `image` string — 카테고리 이미지 URL
    - `childCategories` ChildCategoryResponse[], required — 하위 카테고리 목록
      - `id` string, required — 카테고리 ID
      - `name` string, required — 카테고리 이름
      - `image` string — 카테고리 이미지 URL
      - `createdAt` string, date-time, required — 생성일시
      - `updatedAt` string, date-time, required — 수정일시
    - `createdAt` string, date-time, required — 생성일시
    - `updatedAt` string, date-time, required — 수정일시
  - `error` ErrorMessage
    - `errorCode` 'INTERNAL_ERROR' | 'BAD_REQUEST' | 'NOT_FOUND' | 'CONFLICT' | 'FORBIDDEN' — 에러 코드
    - `message` string — 에러 메시지

---

[API](https://skmtc.dev/archisketch/apis/open-api.md) · [All operations](https://skmtc.dev/archisketch/apis/open-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/archisketch/open-api/revisions/f6b0eda1a99d/schema)