---
title: 셀피 조회
description: 검증 여정 중에 캡처된 워터마크가 적용된 셀피를 조회합니다.
canonical: https://developer.unico.io/ko/developers/api-reference/get-selfie
locale: ko
generated_by: markdown-export
---

- [/ko/](/ko/)
- API 레퍼런스
- 셀피 조회

**이 페이지에서# 셀피 조회

사용자가 Unico가 호스팅하는 여정 중에 캡처한 생체 인식 셀피를 반환합니다. 이미지는 워터마크가 적용된 base64로 인코딩된 문자열로 반환됩니다.
생체 인식 캡처를 수행한 모든 완료된 프로세스에서 사용할 수 있으며, 스마트 재검증(`idsmart`) 여정도 포함됩니다. 생체 인식 캡처 없이 완료된 프로세스(예: 무음 인증)에서는 반환할 셀피가 없으므로 사용할 수 없습니다.
### 엔드포인트​

환경URL**프로덕션**`GET https://api.idcloud.unico.app/client/v1/process/{processId}/selfie`**샌드박스**`GET https://api.idcloud.uat.unico.app/client/v1/process/{processId}/selfie`
### 요청​

헤더
헤더값`Authorization``Bearer <access_token>`([인증](/ko/developers/start/authentication) 참조)
경로 매개변수
매개변수유형필수설명`processId`string (UUID)예[프로세스 생성](/ko/developers/api-reference/post-processes)에서 반환된 프로세스 식별자입니다.
### 예제​

cURLNode.js```
curl -X GET https://api.idcloud.unico.app/client/v1/process/$PROCESS_ID/selfie \  -H "Authorization: Bearer $TOKEN"
```

```
import fetch from 'node-fetch';const res = await fetch(  `https://api.idcloud.unico.app/client/v1/process/${processId}/selfie`,  { headers: { Authorization: `Bearer ${accessToken}` } });const { fileContents, contentType } = await res.json();// fileContents는 base64로 인코딩된 이미지 문자열입니다
```

### 응답​

200 OK
```
{  "fileContents": "/9j/4AAQSkZJR...",  "contentType": "image/jpeg"}
```

필드유형설명`fileContents`string (base64)캡처된 셀피이며, base64로 인코딩되어 있습니다. 워터마크가 포함되어 있습니다.`contentType`string이미지의 MIME 유형입니다 — `image/jpeg` 또는 `image/png`.
### 오류 코드​

참고이 엔드포인트는 API에서 특정 `code` 또는 `message` 값을 제공하지 않습니다.
400 Bad Request401 Unauthorized403 Forbidden404 Not Found`processId` 경로 매개변수가 누락되었거나 형식이 올바르지 않습니다.Bearer 토큰이 누락, 만료, 또는 유효하지 않습니다. [인증](/ko/developers/start/authentication)을 참조하세요.이 프로세스의 셀피에 접근할 권한이 부족합니다.프로세스를 찾을 수 없거나, 생체 인식 캡처 없이 프로세스가 완료되어 반환할 셀피가 없습니다.
### 다음 단계​

전체 프로세스 결과는 [프로세스 조회](/ko/developers/api-reference/get-process)를 참조하세요.
증거 감사 묶음은 [증거 세트 조회](/ko/developers/api-reference/get-evidence-set)를 참조하  세요.
마지막 업데이트 2026년 10월 8일**에