Skip to content

Working with the KIDDE API

CJG edited this page Aug 16, 2024 · 2 revisions

A good thread on the topic is located on the community.home-assistant.io

Step 1: Getting the AUTH Token

Send a POST request to

https://api.homesafe.kidde.com/api/v4/auth/login

The POST Request Body must have your valid Kidde account information

{
    "email": "----",
    "password": "----",
    "timezone": "America/New_York"
}

If your request is valid, the JSON response body will have the access token for the next queries

{
    ...
    "access_token": "----",
    ...
}

Step 2: Getting the Location ID

Then you can call the API for information. You will need the Location ID of your devices. Use the following to get that information.

Send a GET Request to

https://api.homesafe.kidde.com/api/v4/location

The Requesst Headers are as follows. Note that your access_token from the Auth Request replaces ---- for homeboy-auth

homeboy-app-platform: android
homeboy-app-version: 4.0.12
homeboy-app-platform-version: 12
homeboy-app-brand: google
homeboy-app-device: sdk_gphone64_x86_64
homeboy-app: com.kidde.android.monitor1
homeboy-auth: ----
user-agent: com.kidde.android.monitor1/4.0.12
content-type: application/json; charset=UTF-8
cache-control: no-cache

The GET Request Body is the same as provided in the Auth request.

If your request is valid, the JSON response body will have the Location ID used in the device queries

{
     "id": ----,
    ...
}

Step 3: Getting the Device Information

To get all the detail on the devices, use the Location ID in the GET Request, replacing ---- in the URL

https://api.homesafe.kidde.com/api/v4/location/----/device

The GET headers are the same as the location request.

The GET Request Body is the same as provided in the Auth request.

If your request is valid, the JSON response body will the extensive detail of all the devices at the provided location.

Clone this wiki locally