Skip to content
Sensibo Logo Support Center

Overview

Sensibo API (2.0.0)

The Sensibo API is built on HTTP and follows REST principles. It accepts and returns JSON data in all requests.

Client Libraries

You can use any HTTP/REST library in your preferred programming language to interact with our API. We also provide an official Python client library to get you started quickly.

Always use gzip in your requests

Always enable gzip compression by including the header Accept-Encoding: gzip in your requests to get a higher rate limit.

Try it Live

Want to explore the API interactively? Upload this specification file to Swagger Editor to try it live.

Getting Help

Authentication

  1. Generate your API keys in your account settings
  2. Include your API key in requests via the query parameter: ?apiKey={your_api_key}
  3. You can delete and rotate keys as needed from the same settings page

OAuth2

OAuth2 is available for commercial users. To get access and start developing, please contact supprt@sensibo.com with specific details.

Making Requests

GET Requests

Most GET endpoints support a fields parameter to specify which data fields to retrieve:

  • Use comma-separated field names to get specific fields
  • Use fields=* to get all available fields

Common Examples

Get all devices info:

curl --compressed -X GET "https://home.sensibo.com/api/v2/users/me/pods?fields=*&apiKey={api_key}"

Turn AC on:

curl --compressed -X POST "https://home.sensibo.com/api/v2/pods/{device_id}/acStates?apiKey={api_key}" \
  -d '{"acState":{"on":true}}'

Turn AC off:

curl --compressed -X POST "https://home.sensibo.com/api/v2/pods/{device_id}/acStates?apiKey={api_key}" \
  -d '{"acState":{"on":false}}'

Get historical measurements:

curl --compressed "https://home.sensibo.com/api/v2/pods/{device_id}/historicalMeasurements?apiKey={api_key}&days=1"

Rate Limiting

  • Requests are subject to rate limiting
  • HTTP 429 status code indicates you’ve hit the limit
  • Using gzip compression can help increase your rate limits
  • OpenAPI version: 3.1.0

Authentication

api_key

Security scheme type: apiKey

Query parameter name: apiKey