---
title: StarLine
description: Instructions on how to setup your StarLine account with Home Assistant.
ha_category:
  - Binary sensor
  - Car
  - Lock
  - Presence detection
  - Sensor
  - Switch
  - Button
ha_release: 0.103
ha_iot_class: Cloud Polling
ha_config_flow: true
ha_codeowners:
  - '@anonym-tsk'
ha_domain: starline
ha_platforms:
  - binary_sensor
  - device_tracker
  - lock
  - sensor
  - switch
  - button
ha_integration_type: integration
---

The `starline` integration lets you retrieve data of your [StarLine](https://www.alarmstarline.com/) security system from the [StarLine portal](https://my.starline.ru/). You will need a working StarLine account.

This integration provides the following platforms:

- Binary sensors: Hand brake, hood, trunk, alarm status, doors lock state, handsfree, neutral and moving ban status.
- Device tracker: The location of your car.
- Lock: Control the lock of your car.
- Sensors: Battery level, SIM card balance, GSM signal level, fuel volume, mileage, OBD errors, interior temperature and engine temperature.
- Switches: Start/stop engine, heater (webasto), and additional channel.
- Buttons: Sound the horn.
- Services: Update the state, set update frequency. More details can be found [here](#services).

## Prerequisites

Create a new application in the [StarLine developer profile](https://my.starline.ru/developer).

<div class='note'>

You can make up to 1000 API calls per day, which means you could make one approximately every 86 seconds.
By default, the state of integration will be updated every 3 minutes and OBD information will be updated every 3 hours, making 488 calls per day.
It is not recommended to set an update interval of less than 90 seconds.

</div>

{% include integrations/config_flow.md %}

## Services

### Update the state

The service `starline.update_state` fetches the last state of the device from the StarLine server.

This service does not require any attributes.

### Set scan interval

The service `starline.set_scan_interval` sets update frequency for entities.

| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `scan_interval` | no | Update frequency in seconds.

### Set scan OBD interval

The service `starline.set_scan_obd_interval` sets update frequency for OBD information.

| Service data attribute | Optional | Description |
| ---------------------- | -------- | ----------- |
| `scan_interval` | no | Update frequency in seconds.

## Disclaimer

This software is not affiliated with or endorsed by ScPA StarLine Ltd.