---
title: "프로젝트 조회"
method: GET
path: "/api/v1/projects/{id}"
tags: ["프로젝트"]
---

# 프로젝트 조회

`GET /api/v1/projects/{id}`

프로젝트 ID로 프로젝트 상세 정보를 조회합니다.

## Path parameters

- `id` string, required

## Response `200`

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

- ApiResponseProjectDetailResponse
  - `result` 'SUCCESS' | 'FAIL', required — 응답 결과 타입
  - `data` ProjectDetailResponse
    - `id` string, required — 프로젝트 ID
    - `name` string, required — 프로젝트 이름
    - `enterpriseId` string — 엔터프라이즈 ID
    - `floorplans` unknown[], required — 도면 목록
      - unknown
    - `images` ProjectImage[], required — 프로젝트 이미지 목록
      - `type` 'DEFAULT' | 'THUMBNAIL' | 'RENDER', required — 이미지 유형 (DEFAULT: 프로젝트 기본 이미지, THUMBNAIL: 프로젝트 썸네일 이미지, RENDER: 프로젝트 랜더샷 이미지)
      - `imageId` string, required — 이미지 ID
      - `url` string, required — 이미지 URL
      - `order` integer, required — 순서
    - `mapFloorplanDetail` MapFloorplanDetailResponse
      - `id` string, required — ID
      - `mapFloorplanId` string, required — 맵 도면 ID
      - `floorplanDetailId` string, required — 도면 상세 ID
      - `enterpriseId` string, required — 엔터프라이즈 ID
      - `userId` string, required — 사용자 ID
      - `access` string, required — 접근 권한 타입
      - `lat` number, double, required — 위도
      - `lng` number, double, required — 경도
      - `floorplanDetails` FloorplanDetailResponse[], required — 도면 상세 목록
        - `id` string, required — ID
        - `mapFloorplanId` string, required — 맵 도면 ID
        - `preview` string — 미리보기 이미지 URL
        - `status` 'CREATED' | 'WORKING' | 'TESTING' | 'COMPLETED' | 'FAILED', required — 도면 상태
        - `areaInfo` MapFloorplanAreaInfo, required
          - `areaType` string, required — 면적 타입
          - `area` string, required — 면적
          - `supplyArea` string, required — 공급 면적
          - `exclusiveArea` string, required — 전용 면적
        - `assign` MapFloorplanAssign
          - `userId` string — 담당자 사용자 ID
          - `email` string — 담당자 이메일
        - `oldMapId` integer — 이전 맵 ID
        - `createdAt` string, date-time, required — 생성일시
        - `updatedAt` string, date-time, required — 수정일시
      - `address` MapFloorplanAddress, required
        - `id` string, required — 주소 ID
        - `parentId` string, required — 상위 주소 ID
        - `userId` string, required — 사용자 ID
        - `enterpriseId` string — 엔터프라이즈 ID
        - `numberAddress` string — 지번 주소
        - `roadAddress` string — 도로명 주소
        - `zipcode` string — 우편번호
        - `danjiCode` string — 단지 코드
        - `adminCode` string — 행정 코드
        - `roadCode` string — 도로 코드
        - `buildingCode` string — 건물 코드
        - `buildingName` string — 건물명
      - `createdAt` string, date-time, required — 생성일시
    - `ownerUser` ProjectUser, required
      - `id` string, required — 사용자 ID
      - `name` string, required — 이름
      - `email` string, required — 이메일
      - `imageUrl` string — 프로필 이미지 URL
    - `projectAccessUsers` AccessUserResponse[], required — 공유 사용자 목록
      - `id` string, required — 사용자 ID
      - `name` string, required — 이름
      - `email` string, required — 이메일
      - `imageUrl` string — 프로필 이미지 URL
      - `accessType` 'EDIT' | 'VIEW', required — 접근 권한 유형 (EDIT: 수정, VIEW: 보기)
    - `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)