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

# Get Metric Data Upload Progress

##### Request status

The status of an asynchronous request can be checked with `task.status` in the API request result.

| Status    | Description                                                                                                                                        |
| --------- | -------------------------------------------------------------------------------------------------------------------------------------------------- |
| uploaded  | Data has been uploaded to the server.                                                                                                              |
| validated | Validation of the uploaded file is complete.                                                                                                       |
| ingested  | Uploaded files ingested to the database.                                                                                                           |
| succeeded | Uploaded data are processed and available for viewing in reports. Available in dashboard reports in up to 10 minutes.                              |
| failed    | The processing of the uploaded file has failed and needs to be re-uploaded with the correct file, referring to the 'reason' value in the response. |

<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="get-metric-data-upload-progress-request">
  Request
</h2>

***

<h3 id="get-metric-data-upload-progress-headers">
  Headers
</h3>

<ParamField header="Accept-Language" type="string">
  You can specify the language to use for API requests and responses. It follows the ISO-639-1 format.
</ParamField>

<ParamField header="Content-Type" type="string">
  Represents the media type of the resource. Defaults to `application/json`.
</ParamField>

<ParamField header="Authorization" type="string">
  The key value to use for API requests. Instructions for getting API keys are in "[how to generate API Keys](/en/references/introduction#authorization)".
</ParamField>

<h3 id="get-metric-data-upload-progress-path-params">
  Path Params
</h3>

<ParamField path="request_id" type="string" required>
  The `request_id` returned by the result of the 'Upload Data' API.
</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="get-metric-data-upload-progress-response">
  Response
</h2>

***

### 200

| Name       | Description                           | Example                              |
| ---------- | ------------------------------------- | ------------------------------------ |
| requestId  | The request ID.                       | 08844672-62d8-4da8-9d48-e14961651e0c |
| status     | The progress for the upload request.  | ingested                             |
| prevStatus | The status before the current status. | validated                            |
| reason     | The reason the upload failed.         | \{"date": \["invalid date"]}         |
| createdAt  | The date that request was created.    | 2022-08-09T08:59:15                  |
| updatedAt  | The date that request was updated.    | 2022-08-09T08:59:15                  |

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