---
layout: page
title: "FinTS Sensor"
description: "Instructions on how to use the FinTS sensor."
date: 2018-03-25 13:00
sidebar: true
comments: false
sharing: true
footer: true
ha_category: Finance
ha_release: "0.70"
ha_iot_class: "Local Push"
---

With the FinTS sensor, you can fetch your account information from your bank. This only works with banks that support the FinTS (aka. HBCI) standard. The FinTS standard used by many German banks. So if you do not have a German bank account, this will most likely not work for you. To find out if your bank supports FinTS, check the bank's website or call their hotline.

## {% linkable_title Configuration %}

To find out the configuration for your bank, check their website or call their hotline. Do not use random information you find on the Internet! As you're storing your bank account information in the Home Assistant configuration: Make sure that this configuration is not accessible to anyone.

For each account you have with the bank, a separate sensor is created. If you have several accounts with a bank, you can select which ones you want to have, and you can also give the accounts a name.

{% raw %}
```yaml
# Example configuration.yaml entry
sensor:
  - platform: fints
    bank_identification_number: ID_FOR_YOUR_BANK
    username: YOUR_FINTS_USERNAME
    pin: YOUR_PIN
    url: URL_FOR_YOUR_BANK
```
{% endraw %}

{% configuration %}
name:
  description: Name of the bank.
  required: false
  type: string
bank_identification_number: 
  description: Bank identification number, in most cases the "Bankleitzahl".
  required: true
  type: string
username: 
  description: Your FinTS username.
  required: true
  type: string
pin:
  description: Your FinTS PIN or password.
  required: true
  type: string
url: 
  description: URL of your bank's FinTS server.
  required: true
  type: string
accounts:
  description: The balance accounts to show. If not set then all accounts will show up.  
  required: false
  type: list
  keys: 
    account:
      description: The IBAN of the blance account.
      required: true
      type: string
    name:
      description: Use this field to give the account a meaningful name.
      required: false
      type: string
holdings:
  description: The holding accounts of your bank. If not set then all accounts will show up.
  required: false
  type: list
  keys: 
    account:
      description: The classic account number.
      required: true
      type: string
    name:
      description: Use this field to give the account a meaningful name.
      required: false
      type: string 
{% endconfiguration %}
