> ## Documentation Index
> Fetch the complete documentation index at: https://help.airbridge.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Metric Data 업로드 진행 상태 조회하기

##### 업로드 요청 상태

업로드 요청된 파일의 처리 상태는 API 요청 결과의 `status`로 확인할 수 있습니다.

| Status | Description |
| - | - |
| uploaded | API를 통해 데이터가 서버로 업로드 된 상태. |
| validated | 업로드한 파일의 Validation이 완료된 상태. |
| ingested | 업로드한 파일을 데이터베이스에 저장한 상태. |
| succeeded | 업로드한 파일이 리포트에 조회할 수 있도록 처리 완료된 상태. 최대 10분 이내에 대시보드 리포트에서 확인 가능. |
| failed | 업로드한 파일의 처리가 실패한 상태로, Response 중 'reason' 값을 참고하여 올바른 파일로 재업로드 필요. |

```text GET theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
https://api.airbridge.io/self-serve-data/v1/metric/requests/{request_id}
```

## Request

***

### Headers

<ParamField header="Accept-Language" type="string">
  API 요청 및 결과 반환에 사용할 언어를 지정할 수 있습니다. ISO-639-1 포맷을 따릅니다.
</ParamField>

<ParamField header="Content-Type" type="string">
  리소스의 미디어 타입을 나타냅니다. 기본값으로 `application/json`을 사용합니다.
</ParamField>

<ParamField header="Authorization" type="string">
  API 요청에 사용하는 키값입니다. [키값 생성 및 조회 방법](/ko/references/introduction)을 확인하여 획득할 수 있습니다.
</ParamField>

### Path Params

<ParamField path="request_id" type="string" required>
  업로드 요청에 대한 고유 ID.
</ParamField>

<RequestExample>
  ```shellscript Request theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  curl -X GET 'https://api.airbridge.io/self-serve-data/v1/metric/requests/08844672-62d8-4da8-9d48-e14961651e0c' \
    -H 'Accept-Language: ko' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer {AIRBRIDGE-API-TOKEN}'
  ```
</RequestExample>

## Response

***

### 200

| Name | Description | Example |
| - | - | - |
| requestId | 업로드 요청에 대한 고유 ID로, 매 요청마다 새로운 ID가 부여됩니다. 업로드 요청 상태 조회 시 해당 ID가 사용됩니다. | 08844672-62d8-4da8-9d48-e14961651e0c |
| status | 업로드 요청에 대한 진행 상태값입니다. | ingested |
| prevStatus | 현재 status 이전의 상태값입니다. | validated |
| reason | status가 'failed'로 업로드 실패 이유에 대한 값입니다. | \{"date": \["invalid date"]} |
| createdAt | 요청이 생성된 날짜 및 시간입니다. | 2023-01-01T09:00:00 |
| updatedAt | 업데이트가 진행된 날짜 및 시간입니다. | 2023-01-01T09:00:00 |

### 200

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  {
    "reason": null,
    "status": "succeeded",
    "createdAt": "2023-01-01T09:00:00",
    "requestId": "08844672-62d8-4da8-9d48-e14961651e0c",
    "updatedAt": "2023-01-01T09:00:00",
    "prevStatus": "ingested"
  }
  ```

  ```json 200 theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  {
    "reason": "{\"date\": [\"invalid date\"]}",
    "status": "failed",
    "createdAt": "2022-08-24T11:54:18",
    "requestId": "846b78f9-1b6f-4ede-a253-619ca68fcebf",
    "updatedAt": "2022-08-24T11:54:17",
    "prevStatus": "uploaded"
  }
  ```
</ResponseExample>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.