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

# 리포트 가져오기

###### 비동기 요청 상태

비동기 요청 상태는 API 요청 결과의 `task.status`로 확인할 수 있습니다.

| <span style={{ display: 'inline-block', minWidth: '130px' }} /> | |
| - | - |
| `PENDING` | 데이터 집계를 위한 준비를 하고 있습니다 |
| `RUNNING` | 데이터를 집계중입니다 |
| `SUCCESS` | 집계가 완료되어 결과값을 반환합니다 |
| `FAILURE` | 알 수 없는 이유로 요청이 실패하였습니다 |
| `CANCELED` | 요청이 취소되었습니다 |

```text GET theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
https://api.airbridge.io/reports/api/v4/apps/{app_name}/active-users/query/{task_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="app_name" type="string" required>
  에어브릿지 앱 이름(App Name)
</ParamField>

<ParamField path="task_id" type="string" required>
  '리포트 생성하기' API의 결과값에서 반환한 `task_id`입니다.
</ParamField>

<RequestExample>
  ```shellscript Request theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  curl -X GET 'https://api.airbridge.io/reports/api/v4/apps/{app_name}/active-users/query/{task_id}' \
    -H 'Accept-Language: ko' \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer {AIRBRIDGE-API-TOKEN}'
  ```
</RequestExample>

## Response

***

### 200

### 200

### 404

<ResponseExample>
  ```json 200 theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  {
    "task": {
      "status": "RUNNING",
      "taskId": "5e286bd4-b4b1-4c04-8f6a-123456789abc",
      "endedAt": "2023-01-01T09:00:00.286939+09:00"
    }
  }
  ```

  ```json 200 theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  {
    "task": {
      "status": "SUCCESS",
      "taskId": "5e286bd4-b4b1-4c04-8f6a-670dc7ce637d",
      "endedAt": "2022-07-29T04:40:52+00:00"
    },
    "activeUsers": {
      "data": [
        {
          "rows": [
            {
              "date": "2022-07-23T00:00:00+09:00/2022-07-24T00:00:00+09:00",
              "values": {
                "app_au": 7,
                "app_pu": 0,
                "app_arpu": 0,
                "app_arppu": 0,
                "app_revenue": 0
              }
            },
            {
              "date": "2022-07-24T00:00:00+09:00/2022-07-25T00:00:00+09:00",
              "values": {
                "app_au": 8,
                "app_pu": 0,
                "app_arpu": 0,
                "app_arppu": 0,
                "app_revenue": 0
              }
            }
          ],
          "groupBys": []
        }
      ]
    }
  }
  ```

  ```json 404 theme={"theme":{"light":"github-dark-dimmed","dark":"github-dark-dimmed"}}
  {
    "type": "about:blank",
    "title": "Not Found",
    "status": 404,
    "traceId": "1-000000-000000000000000"
  }
  ```
</ResponseExample>


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