> ## 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' 값을 참고하여 올바른 파일로 재업로드 필요. |

<Card title="Try API Request" icon="rectangle-api" horizontal href="https://api.airbridge.io/custom-data-upload/v1.0/self-serve/requests/:requestId" />

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

<h2 id="metric-data-업로드-진행-상태-조회하기-request">
  Request
</h2>

***

<h3 id="metric-data-업로드-진행-상태-조회하기-headers">
  Headers
</h3>

<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>

<h3 id="metric-data-업로드-진행-상태-조회하기-path-params">
  Path Params
</h3>

<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>

<h2 id="metric-data-업로드-진행-상태-조회하기-response">
  Response
</h2>

***

### 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>