---
metadata:
  - name: generator
    content: Diplodoc Platform v5.50.6
alternate:
  - https://appmetrica.yandex.by/docs/en/mobile-api/datastream/ref/status.md
  - https://appmetrica.yandex.by/docs/ru/mobile-api/datastream/ref/status.md
---
> **Documentation Index:** Fetch the complete configuration index at https://appmetrica.yandex.by/docs/en/llms.txt

# Stream status

Returns a list of streams for each event type. Each stream contains a list of 5-minute windows with data sizes and the composition of export fields.

## Request format {#request-format}

```
GET https://api.appmetrica.yandex.com/datastream/v1/application/{id}/status
```

#|
|| `id` | App ID ||
|#

## Response format {#output-structure}

```json translate=no
{
    "status": {
        "streams": [
            {
                "data_type": string,
                "stream_windows": [
                    {
                        "stream_window_timestamp": int,
                        "export_schema_id": int,
                        "payload_bytes": int,
                        "event_count": int,
                        "update_timestamp": int
                    },
                    ...
                ]
            },
            ...
        ],
        "export_fields": [
            {
                "export_schema_id": int,
                "field_names": [
                    "event_datetime",
                    "event_json",
                    "event_name",
                    "event_timestamp",
                    "session_id",
                    "installation_id",
                    "appmetrica_device_id",
                    "city",
                    "connection_type",
                    "country_iso_code",
                    ...
                ]
            },
            ...
        ]
    }
}
```

#|
|| `status` | API response. ||
|| `status.streams` | List of streams with export data. ||
|| `status.streams[i].data_type` | The type of data that forms the stream.

Acceptable values:
- `event`
- `installation`
- `session_start`
- `session_end`
- `push_token`
- `crash`
- `error`
- `click`
- `revenue`
- `ecommerce`
- `ad_revenue`
- `attributed_event`
- `deeplink`
 ||
|| `status.streams[i].stream_windows` | List of stream windows. ||
|| `status.streams[i].stream_windows[j].stream_window_timestamp` | Unix timestamp in seconds pointing to the data window. It is used to specify a window for downloading data. ||
|| `status.streams[i].stream_windows[j].export_schema_id` | ID of the set of CSV fields. ||
|| `status.streams[i].stream_windows[j].payload_bytes` | The size of the CSV file in bytes, excluding the CSV header. ||
|| `status.streams[i].stream_windows[j].event_count` | The number of events in the CSV file. ||
|| `status.streams[i].stream_windows[j].update_timestamp` | Unix timestamp in seconds. Indicates the time of the last data change in this window. Changes occur in the last windows to which data is currently being appended. ||
|| `status.export_fields` | Contains a list of sets of CSV fields that were used to generate data windows. ||
|| `status.export_fields[i].export_schema_id` | ID of the set of CSV fields. ||
|| `status.export_fields[i].field_names` | List of string names of fields selected for export. For more information about the fields, see [Data types for export](https://appmetrica.yandex.by/docs/en/mobile-api/datastream/data-type-fields.md). ||
|#

## Example {#example}

Request:

```bash translate=no
curl -X GET 'https://api.appmetrica.yandex.com/datastream/v1/application/1111/status' \
-H 'Authorization: OAuth oauth_token'
```

Response:

```json translate=no
{
    "status": {
        "streams": [
            {
                "data_type": string,
                "stream_windows": [
                    {
                        "stream_window_timestamp": int,
                        "export_schema_id": int,
                        "payload_bytes": int,
                        "event_count": int,
                        "update_timestamp": int
                    },
                    ...
                ]
            },
            ...
        ],
        "export_fields": [
            {
                "export_schema_id": int,
                "field_names": [
                    "event_datetime",
                    "event_json",
                    "event_name",
                    "event_timestamp",
                    "session_id",
                    "installation_id",
                    "appmetrica_device_id",
                    "city",
                    "connection_type",
                    "country_iso_code",
                    ...
                ]
            },
            ...
        ]
    }
}
```

<!-- source: en/_includes/feedback-button-3.md -->
If you didn't find the answer you were looking for, you can use the feedback form to submit your question. Please describe the problem in as much detail as possible. Attach a screenshot if possible.

<a href="../../../troubleshooting/feedback-new">
  <span class="button">Contact support</span>
</a>

<a href="../../../troubleshooting/feedback-docs">
  <span class="button">Suggest an improvement for documentation</span>
</a>
<!-- endsource: en/_includes/feedback-button-3.md -->