Skip to content

Quick Start

Getting started with using Fire APIs involves the following steps:

  1. Create an account and a machine user
  2. Create a JSON Web Token (JWT) by using the machine user credentials
  3. Make API requests using the JWT


In the following examples we are:

  1. making use of a Linux/MacOS shell in which environmental variables are set using the export-command. In other environments it may be different, e.g. Windows uses the set-command instead.

  2. using the curl as a client. But the API can be used in any programming language with an HTTP Client, e.g. Go, Python, NodeJS, Javascript and Java.

Create an account and a machine user

The Getting Started page documents the required steps to get a hold of the clientId, clientSecret and partitionId.

Create a token

Use the values described in the Authorization- section to construct the Create Token request.

Example request


curl \
  -H 'content-type: application/json' \
  -d "{

To run this example yourself, set the CLIENT_ID and CLIENT_SECRET first.

Example response

  "access_token": "eyJ0eXAiOiUSJ9.eyJpc3MiOiJdGlhbHMifQ.MJpcxLfyOt",
  "token_type": "Bearer",
  "expires_in": 86400

The token, or JWT (JSON Web Token), is the value of the access_token-property in the response. You can now use it by passing it in the Authorization-header of any subsequent API requests. The expires_in-property represents the number of seconds your token is valid, usually, the value corresponds to 24 hours. When this time has elapsed you will need to create a new token.

Now you have all you need to start using the API. As a last step of preparation set the token and partitionId as environmental variables.


Make API requests

This guide will take you through the steps you need to perform to read events of panel. We will assume you don't yet know the id of the panel & device, meaning that before you can get the events data of the panel you must discover the device by listing Locations and Devices.

List Locations

The first step to perform is to list the buildings in your partition. This you can do by performing the List Locations operation.

curl -H "Authorization: Bearer $TOKEN" \

The response contains all buildings in your partition. If you have a large number of buildings you may need to retrieve multiple pages, see Pagination.

Select the id property of one of the locations in the response and set it in an environmental variable. E.g. if the id is 8db4216d-61c5-4e79-8558-164aa179bfe9 then set it using the following command:

export LOCATION=8db4216d-61c5-4e79-8558-164aa179bfe9

List Devices

The next step is to list the devices available in your building. This is achieved by using the List Devices operation.

curl -H "Authorization: Bearer $TOKEN" \

The response contains a list of all devices with their location defined as the building you specified.

List Events

To get past events and alarms for a device, the List Events operation can be used:

curl -H "Authorization: Bearer $TOKEN" \


For more details on deprecation policies and common API features such as paging, filtering and errors, refer to the Developer's Guide.




Connect and Collaborate with Industrial Professionals and Join the Community!

Click to load comments