Senseworks Developers

Senseworks API

Build your integration.

Connect your tools to Senseworks. Start with authentication, then explore the endpoints and response schemas.

Get started

Your first API request

Use the client ID and secret supplied by Senseworks to obtain a token. Keep credentials on your server. The example requires the companyinformation scope.

Both API versions use POST /v1/token. For a different organisation your client can access, send X-Tenant-Id.

Authenticate and list companies · V1Shell 
# Set CLIENT_ID and CLIENT_SECRET in your environment.
TOKEN=$(curl --fail-with-body --silent --show-error \
  https://api.senseworks.app/v1/token \
  --data-urlencode "client_id=$CLIENT_ID" \
  --data-urlencode "client_secret=$CLIENT_SECRET" \
  | jq -er '.access_token')

curl --fail-with-body --silent --show-error \
  https://api.senseworks.app/v1/companies \
  -H "Authorization: Bearer $TOKEN"

V2 API reference

Search endpoints, inspect parameters and explore response schemas. Sending requests from this page is disabled.