# Data Sessions {% hint style="info" %} This endpoint in only applicable for **BACE GO**. Not sure which device you are working with? Find out [here](/reference/powering-iot-connectivity-modules.md). {% endhint %} Whenever a **BACE Go** is turned on, a Data Session is created automatically in the BACE cloud. The Data Session is automatically closed when the device is turned off. ![](/files/7qEJEOjuUcFjKJtrkMic) The BACE API for Data Sessions allows you to: * Get information about the Data Session * Get information about the device reporting data * Get all data associated with Data Session To start getting Data Sessions data from the BACE API, you must have: * An active User account * A physical or virtual device (able to start/stop Data Session) provisioned and related to your project * (Optionally) a peripheral or sensor connected to your BACE device ## How to get Data Sessions Data? To retrieve data from a data session, two request are required: * List all Data Sessions * Get specific data from session * Download full session in CSV file ### List all Data Sessions To get list of all Data Sessions in the system available for you, you should make a GET request `GET``https://`dashboard.bace-iot.com`/api/v2/data-session?sort=-star` In our example we will sort Data Sessions on start time descending, such that the latest Data Sessions that was started is in the beginning of the list. ```json { "items": [ { "id_data_session": "86d70a1b-...", "id_group": "4c1c81ca-...", "id_person": null, "label": "BACE Go XXX 2022-03-30 14:04", "start": 1648641893, "end": 1648643067, "created_at": 1648641897, "created_by": null, "updated_at": 1648643384, "updated_by": null, "archived_at": null, "datapoint_count": 10, "isIngestionFinished": true, "isArchived": false, "_links": { "self": { "href": "https://dashboard.bace-iot.com/api/v2/data-session/view?id=86d70a1b-..." }, "index": { "href": "https://dashboard.bace-iot.com/api/v2/data-session/index" } } }, ... ] "_links": { "self": { "href": "https://dashboard.bace-iot.com/api/v2/data-session?sort=-start&page=1" }, "first": { "href": "https://dashboard.bace-iot.com/api/v2/data-session?sort=-start&page=1" }, "last": { "href": "https://dashboard.bace-iot.com/api/v2/data-session?sort=-start&page=274" }, "next": { "href": "https://dashboard.bace-iot.com/api/v2/data-session?sort=-start&page=2" } }, "_meta": { "totalCount": 5474, "pageCount": 274, "currentPage": 1, "perPage": 20 }, "expand": [ "datatypes", "datatypesFilter", "creator", "updater", "physicalDevicesFilter", "physicalDevices", "fromDevice", "group", "dataIds" ], "labels": { "group.label": "Group", "person.label": "Person", "person.objectLink": "Person", "sourceDevicesString": "Source Devices", "datatypesString": "Datatypes", "ingestionStatusString": "Ingestion", "archivingStatusString": "Archived" } } ``` In the response you will get basic information about all Data Sessions. You have access to the following fields: | Field | Description | | ------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | id\_data\_session | UUID of the Data session | | id\_group | UUID of the Group device is in. To get more information use: expand=group | | id\_person | UUID of the Person related to the Datasession | | label | Descriptive label for the datasession | | start | Data session start timestamp in seconds | | end | Data session end timestamp in seconds. null - if Data session is active and not stopped | | created\_at | Timestamp in seconds, when Data sessions record have been created | | created\_by | UUID of the User, who have created Data session. For Data session started from the device - null. To get more information use: expand=creator | | updated\_at | Timestamp in seconds, when Data sessions record have been last updated | | updated\_by | UUID of the User, who have last updated Data session. For Data session updated from the device - null. To get more information use: expand=updater | | archived\_at | Timestamp in seconds, when Data session have been archived | | datapoint\_count | Total datapoint count in the Data session | | isIngestionFinished | Boolean describing data ingestion process | | isArchived | Boolean describing, if archiving of Data session have been finished | ### Get data from Data Session To get specific data associated with a Data Session. You should make a GET request from the `data-downsampled` endpoint, specifiying the session ID. `GET`` ``https://dashboard.bace-iot.com/api/v2/data-downsampled?filter[id_data_session]=ID_DATA_SESSION` Example response: ```json { "items": [ { "id_container_data_latest": "c1dafb46-...", "id_group": "4c1c81ca-...", "datatype": 5205, "source_device": "6b88b4df-...", "timestamp_seconds": 1648641939.995, "min_val": 3.95, "max_val": 3.95, "avg_val": 3.95, "count_val": 1 }, { "id_container_data_latest": "c1dafb46-...", "id_group": "4c1c81ca-...", "datatype": 5205, "source_device": "6b88b4df-...", "timestamp_seconds": 1648642239.995, "min_val": 3.94, "max_val": 3.94, "avg_val": 3.94, "count_val": 1 }, ... ], "_links": { "self": { "href": "https://dashboard.bace-iot.com/api/v2/data-downsampled?filter%5Bid_data_session%5D=86d70a1b-...&page=1" }, "first": { "href": "https://dashboard.bace-iot.com/api/v2/data-downsampled?filter%5Bid_data_session%5D=86d70a1b-...&page=1" }, "last": { "href": "https://dashboard.bace-iot.com/api/v2/data-downsampled?filter%5Bid_data_session%5D=86d70a1b-...&page=1" } }, "_meta": { "totalCount": 10, "pageCount": 1, "currentPage": 1, "perPage": 500 } } ``` | Field | Description | | --------------------------- | ----------------------------------------------------------------------- | | id\_container\_data\_latest | UUID which describes combination of Group, Physical Device and Datatype | | id\_group | UUID of Group | | datatype | Datatype of stored data | | source\_device | UUID of Physical Device, BACE Cloud have received data from | | timestamp\_seconds | Timestamp in seconds | | min\_val | Minimal value | | max\_val | Maximal value | | avg\_val | Average value | | count\_val | Count of downsampled samples | If data is downsampled, the field count\_val is greater than 1. In this case, you can also request data between 2 timestamps to get data with a higher resolution, i.e. more datapoints. More information about [downsampling mechanism ](/api/accessing-data.md#downsampling-mechanism)and how to use [data-downsampled endpoint](/api/accessing-data.md#using-downsampled_data-endpoint) ### Download data in .csv file To download the complete Data Session in a CSV file, you should make GET request from the download-csv endpoint. `GET`` ``https://dashboard.bace-iot.com/api/v2/data-session/ID_DATA_SESSION/download-csv` --- # 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://docs.bace-iot.com/api/data-sessions.md?ask= ``` 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.