---
title: "문서 번역 상태 확인"
slug: "ai-naver-papagodoctranslation-status"
tags: ["Papago Doc Translation", "Papago Translation"]
updated: 2026-07-23T09:04:18Z
published: 2026-07-23T09:04:18Z
canonical: "api.ncloud-docs.com/ai-naver-papagodoctranslation-status"
---

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

# 문서 번역 상태 확인

Classic/VPC 환경에서 이용 가능합니다.

문서 번역의 진행 상태를 현재 처리 단계 및 진행률(%)로 확인합니다.

## 요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

| 메서드 | URI |
| --- | --- |
| GET | /status |

### 요청 헤더

Papago Translation API에서 공통으로 사용하는 헤더에 대한 정보는 [Papago Translation 요청 헤더](/docs/ai-naver-papagonmt#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 요청 쿼리 파라미터

요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `requestId` | String | Required | 번역 요청으로 발급된 아이디(Request ID) - 각 문서 번역 요청에 대한 고유한 식별 값 |

### 요청 예시

요청 예시는 다음과 같습니다.

```
curl --location --request GET 'https://papago.apigw.ntruss.com/doc-trans/v1/status?requestId={requestId}' \
--header 'X-NCP-APIGW-API-KEY-ID: {앱 등록 시 발급받은 Client ID}' \
--header 'X-NCP-APIGW-API-KEY: {앱 등록 시 발급 받은 Client Secret}'
```

## 응답

응답 형식을 설명합니다.

### 응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `data` | Object | - | 진행 상태 상세 정보 |
| `data.status` | String | - | 현재 번역 진행 단계 - `WAITING` \| `PROGRESS` \| `COMPLETE` \| `FAILED` - `WAITING`: 번역 대기 - `PROGRESS`: 번역 진행 중 - `COMPLETE`: 번역 완료 및 파일 다운로드 가능 - `FAILED`: 번역 실패 |
| `data.progressPercent` | Integer | - | 파일 번역 진행률(%) - `status`가 `PROGRESS`일 때 확인 가능 |
| `data.errCode` | String | - | 오류 코드 - `status`가 `FAILED`일 때 확인 가능 |
| `data.errMsg` | String | - | 오류 메시지 - `status`가 `FAILED`일 때 확인 가능 |

### 응답 상태 코드

Papago Translation API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Papago Translation 응답 상태 코드](/docs/ai-naver-papagonmt#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오.

### 응답 예시

응답 예시는 다음과 같습니다.

#### 성공

호출이 성공한 경우의 응답 예시는 다음과 같습니다.

```
{
    "data": {
        "status": "COMPLETE"
    }
}
```

```
{
    "data": {
        "status": "PROGRESS",
        "progressPercent": 24
    }
}
```

#### 실패

호출이 실패한 경우의 응답 예시는 다음과 같습니다.

```
{
    "data": {
        "status": "FAILED",
        "errCode": "17",
        "errMsg": "Detected langcode is the same as target langcode"
    }
}
```