# Realtime

The Realtime endpoint allows viewing analytics of real-time users and interactions with a maximum 7 day range. This end point allows real-time analytics to be viewed for Apps, Stories, Pathways OR Streams.  

## Available Realtime Endpoints

`v1/analytics/realtime/apps`\
Get real-time analytics for an app or a list of apps.

`v1/analytics/realtime/pathways`\
Get real-time analytics for a pathways or a list of pathways.

`v1/analytics/realtime/streams`\
Get real-time analytics for a stream or a list of streams.

`v1/analytics/realtime/stories`\
Get real-time analytics for a story or a list of stories.

## Parameters

There are two optional parameter on the real-time endpoints. The items parameter allows you to filter items based on the name or ID of the item. If the item parameter is not provided the endpoint will return the latest 10 items.

For range this option allows you to select a predefined range from 0 - 7.<br>

<table><thead><tr><th width="171.4726418261161"></th><th></th></tr></thead><tbody><tr><td><strong>Key</strong></td><td><strong>Type</strong></td></tr><tr><td><strong>items</strong></td><td><strong>Array Strings</strong><br>Name or ID of the items to filter.</td></tr><tr><td><strong>range</strong></td><td><strong>Int</strong><br>The range option to use. Defaults to 1.</td></tr></tbody></table>

### Range Options

|               |               |
| ------------- | ------------- |
| **0**         | The Last Hour |
| **1 Default** | Last 24 Hours |
| **2**         | Last 2 Days   |
| **3**         | Last 3 Days   |
| **4**         | Last 4 Days   |
| **5**         | Last 5 Days   |
| **6**         | Last 6 Days   |
| **7**         | Last 7 Days   |

## Examples

### Get Latest 10 Pathways

The example below makes a call to the `realtime/pathways` endpoint without a items parameter.

```
curl -X POST \
  v1/analytics/realtime/pathways \
  -H 'Authorization: Basic <Your Base64 Encoded Token>'\
```

### Get a Single App

The example below makes a call to the `realtime/apps` endpoint with a single item in the items parameter.

```
curl -X POST \
  v1/analytics/realtime/apps \
  -H 'Authorization: Basic <Your Base64 Encoded Token>'\
  -d '{
    "items" : ["Learning App"] 
  }'
```

### Get 2 Specific Stories

The example below makes a call to the `realtime/stories` endpoint with an items parameter set to two stories.&#x20;

```
curl -X POST \
  v1/analytics/realtime/stories \
  -H 'Authorization: Basic <Your Base64 Encoded Token>'\
  -d '{
    "items" : ["Story A","Story B"] 
  }'
```

## Success Response

Whichever `realtime` endpoint you are using a successful response will return an array of items with each item containing a context item (app, pathway, stream or story) and corresponding `realtime` data. The example below shows a successful response when using the `realtime/apps` endpoint.

```
{
    "status": "success",
    "data": [
        {
            "app": {
                "name": "Falkor",
                "version": "2.10.1",
                "type": "app",
                "ID": "io.falkor.demo"
            },
            "realtime": [
                {
                    "range": [
                        "2022-02-18T10:49:40+02:00",
                        "2022-02-19T10:49:40+02:00"
                    ],
                    "sessions": 1375,
                    "interactions": 4567
                },
                {
                    "range": [
                        "2022-02-19T10:49:40+02:00",
                        "2022-02-20T10:49:40+02:00"
                    ],
                    "sessions": 1266,
                    "interactions": 3984
                },
                ...etc
            ]
        },
        {
            "app": {
                "name": "The Everyday App",
                "version": "2.10.1",
                "type": "app",
                "ID": "io.falkor.theeverydayapp"
            },
            "realtime": [
                {
                    "range": [
                        "2022-02-18T10:49:40+02:00",
                        "2022-02-19T10:49:40+02:00"
                    ],
                    "sessions": 310,
                    "interactions": 645
                },
                {
                    "range": [
                        "2022-02-19T10:49:40+02:00",
                        "2022-02-20T10:49:40+02:00"
                    ],
                    "sessions": 157,
                    "interactions": 320
                },
                ...etc
            ]
        },
        ...etc
    ],
    "hash": "a936c922af60b3849d2c44b93c1ae37b",
    "response_time": 0.22345805168151855
}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://everyday-digital.gitbook.io/falkor-dev-docs/analytics/realtime.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.