---
title: "Data Connection: Pull Stack Configuration"
description: "How to configure the TWAICE Pull Stack connection to fetch BESS data from your system: required settings, data format and an example."
---

[Skip to content](https://support.twaice.com/knowledge/data-connection-pull-stack-configuration#main-content)

![TWAICE Help CenterWordmark (2)](https://support.twaice.com/hs-fs/hubfs/Wordmark%20(2).png?width=138&height=28&name=Wordmark%20(2).png)

Open main navigation

Close main navigation

- [Contact us](mailto:support@twaice.com)

[Contact us](mailto:support@twaice.com)

 How can we help you?

- There are no suggestions because the search field is empty.

1. [Help Center](https://support.twaice.com/knowledge?hsLang=en)
2. [Onboarding Guideline](https://support.twaice.com/knowledge/onboarding-guideline?hsLang=en)
3. [Data Connection Methods](https://support.twaice.com/knowledge/onboarding-guideline?hsLang=en#data-connection-methods)

# Data Connection: Pull Stack Configuration

## Set up the TWAICE Pull Stack to retrieve data from your databases and APIs, with key features, system requirements and implementation steps.

**On this page**

- [Overview](https://support.twaice.com/knowledge/data-connection-pull-stack-configuration#h_af5a71ac4f)
- [Key Features](https://support.twaice.com/knowledge/data-connection-pull-stack-configuration#h_79343bce74)
- [System Requirements](https://support.twaice.com/knowledge/data-connection-pull-stack-configuration#h_373f5dbc57)
- [Implementation Overview](https://support.twaice.com/knowledge/data-connection-pull-stack-configuration#h_f41552e925)
- [Configuration Requirements](https://support.twaice.com/knowledge/data-connection-pull-stack-configuration#h_fc6856ce05)
- [1. Credentials of the Datastore](https://support.twaice.com/knowledge/data-connection-pull-stack-configuration#h_9c60d1c3bd)
- [A) REST Endpoint](https://support.twaice.com/knowledge/data-connection-pull-stack-configuration#h_afb8314c8d) 
    - [URL](https://support.twaice.com/knowledge/data-connection-pull-stack-configuration#h_3fd2b03b69)
    - [Authentication:](https://support.twaice.com/knowledge/data-connection-pull-stack-configuration#h_68d47bf45e)
- [B) Datastore](https://support.twaice.com/knowledge/data-connection-pull-stack-configuration#h_ceb696e817)
- [2. Data Format Requirements](https://support.twaice.com/knowledge/data-connection-pull-stack-configuration#h_7abe5efe55)
- [Example Data Format](https://support.twaice.com/knowledge/data-connection-pull-stack-configuration#h_70372bd5d2)
- [3. Additional Configuration Parameters](https://support.twaice.com/knowledge/data-connection-pull-stack-configuration#h_1034c4332d)
- [Need Help?](https://support.twaice.com/knowledge/data-connection-pull-stack-configuration#h_9d89ef0470)

### Overview

The TWAICE Pull Stack retrieves data from your databases and APIs on a scheduled, batched basis. It is designed for periodic retrieval of data.

### Key Features

**Flexible connectivity.** The Pull Stack can connect to data sources hosted on-site, on-premise, or in another cloud environment.

**Batch retrieval.** Pull intervals are configured based on your infrastructure to retrieve data efficiently without overloading your network or data source. The Pull Stack is not suitable for stream data processing typical in bus systems.

**Alerting and backfill.** The system alerts on data retrieval failures. If a connection is interrupted, missed data is automatically backfilled once the connection is restored.

**Security.** Static IP addresses are provided for firewall whitelisting.

**Site-to-Site VPN Support**. A Site-to-Site VPN can be configured separately, at additional cost, to ensure secure and encrypted data transmission to TWAICE.

### System Requirements

- **Python Library**: A Python library (version 3.12 or higher) is required for TWAICE to connect and retrieve data from your data source.
- **Data Source Accessibility**: The Pull Stack must be able to access your data source in batches.

### Implementation Overview

Pull Stack setup and testing takes **approximately 2 weeks** once the necessary data connection details, credentials, and parameters are provided to TWAICE.

[![](https://support.twaice.com/hubfs/Knowledge%20Base%20Import/image-Oct-20-2026-12-28-52-6089-PM.png)](https://downloads.intercomcdn.eu/i/o/thagvi83/160140678/4ca3f01701105d1beb28838301f2/image.png?expires=1792501200&signature=714508036e9e7d4fce5bb7c15f5c9cc26bf075ba8a9e3b84217b92cc9ae9366d&req=0dNvxFz6qjAglxv889osp356o0fSYzIvwIU4fqB0pmaGwZEgmCv7WKCQiDsC%0AhFWmxAUM8uDCX8L66Q%3D%3D%0A)

1. **Set up the Pull Stack**: TWAICE generates and deploys a pull client to interface with your database or API. You must have a Python library (version 3.12 or higher) that is installed and configured.
2. **Configure Site-to-Site VPN (if applicable)**: If the database is on-premises, TWAICE sets up a Site-to-Site VPN to securely connect the Pull Stack to the local database.

     1. *Note: Site2Site VPN comes with additional costs and requires additional scoping.*
3. **Deployment**: TWAICE provisions the Pull Stack in an isolated VPC within the AWS Cloud.
4. **Configure Security Settings (optional)**: TWAICE applies any necessary security configurations, including IP whitelisting and other access controls.
5. **Schedule Batch Data Retrieval**: TWAICE creates the batch processing schedule to periodically pull data from the your data source.

**Configure Site-to-Site VPN (if applicable)**: If the database is on-premises, TWAICE sets up a Site-to-Site VPN to securely connect the Pull Stack to the local database.

### Configuration Requirements

### 1. Credentials of the Datastore

### A) REST Endpoint

#### URL

If your data source is a REST endpoint, please provide:

| **Field** | **Description** |
| --- | --- |
| URL | The endpoint URL where the data can be accessed. |

 

#### Authentication:

Please provide the credentials for whichever method your endpoint uses.

| **Field** | **Description** |
| --- | --- |
| API key | If your endpoint uses API key-based authentication |
| Token | If token-based authentication is used |
| Username / Password | If basic authentication is used |

 

### B) Datastore

If your data source is a traditional datastore *(e.g., SQL database, NoSQL database)*, please provide:

| **Field** | **Description** |
| --- | --- |
| Connection string | The connection string or URL to access the datastore |
| Username | Username with the necessary permissions to access the datastore |
| Password | Password for the provided username |

 

### 2. Data Format Requirements

To ensure compatibility with our Pull Stack, the data returned from your datastore or REST endpoint should be structured with the following fields:

| **Field** | **Description** |
| --- | --- |
| Sensor tag | A unique identifier for each sensor |
| Timestamp | The timestamp of the recorded data |
| Value | The value recorded by the sensor |

 

### Example Data Format

```
[  {    "sensor_tag": "temperature_sensor_01",    "relative_time": 1622547800,    "sensor_value": 22.5  },  {    "sensor_tag": "humidity_sensor_02",    "relative_time": 1622547860,    "sensor_value": 55.2  }]
```

 

### 3. Additional Configuration Parameters

TWAICE has a required questionnaire that must be answered prior to any configuration or setup efforts. These parameters ensure that the pull client setup is aligned with your system capabilities and infrastructure.

Responses should be provided to your Customer Success contact or to *[support@twaice.com](mailto:support@twaice.com).*

The [Pull Stack Questionnaire can be found here](https://support.twaice.com/knowledge/data-connection-pull-stack-connection-questionnaire?hsLang=en).

### Need Help?

Contact your TWAICE representative or email [support@twaice.com](mailto:support@twaice.com).

© 2026 TWAICE Technologies GmbH

[twaice.com](https://www.twaice.com)      [Privacy](https://www.twaice.com/legal/data-protection-notice)      [Imprint](https://www.twaice.com/legal/legal-notice)