---
updatedAt: 2026-10-05T15:39:39.000Z
agentTools:
projectIndex: https://developer.ops-execution.crunchtime.com/llms.txt
---
# List Sensors
Get the **properties** of all existing **sensors** corresponding to your company.
##### RECIPES
# OpenAPI definition
```json
{
"openapi": "3.1.0",
"info": {
"title": "zenput-staging",
"version": "1.06"
},
"servers": [
{
"url": "https://staging.ops-execution.crunchtime.com/api/"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"in": "header",
"x-default": "",
"name": "X-API-TOKEN"
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/v2/sensors/sensors/": {
"get": {
"summary": "List Sensors",
"description": "Get the **properties** of all existing **sensors** corresponding to your company.",
"operationId": "get-sensors-v2-ref",
"parameters": [
{
"name": "account_id",
"in": "query",
"description": "Filter results to given accound id (location)",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "sensor_id",
"in": "query",
"description": "Filter results to given sensor id (DevUI for lorawan sensors, ID for monnit sensors)",
"schema": {
"type": "string"
}
},
{
"name": "placement_id",
"in": "query",
"description": "Filter results to given placement id",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "is_online",
"in": "query",
"description": "Filter results to given value, true for online sensors and false for offline sensors",
"schema": {
"type": "boolean"
}
},
{
"name": "search",
"in": "query",
"description": "Query to search across the following attributes: name and sensor id",
"schema": {
"type": "string"
}
},
{
"name": "limit",
"in": "query",
"description": "Number of results to return per page.",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "start",
"in": "query",
"description": "The initial index from which to return the results.",
"schema": {
"type": "integer",
"format": "int32"
}
},
{
"name": "meta_only",
"in": "query",
"description": "Return only data within the meta key.",
"schema": {
"type": "boolean"
}
},
{
"name": "order_by",
"in": "query",
"description": "Sort order of result. A value may be prefixed by a - to specify a descending sort. `\"name\"`,`\"placement__name\"`,`\"account__name\"`,`\"last_reading_value\"`,`\"last_reading_date\"`,`\"is_online\"` or `\"is_enabled\"`",
"schema": {
"type": "string"
}
}
],
"responses": {
"200": {
"description": "200",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\n \"meta\": {\n \"status_code\": 200,\n \"count\": 999,\n \"next\": \"https://www.zenput.com/api/v2/sensors/sensors/?limit=1&start=1\",\n \"previous\": null\n },\n \"data\": [\n {\n \"id\": 42,\n \"name\": \"Fridge Sensor\",\n \"account\": {\n \"id\": \"1\",\n \"name\": \"Location name\",\n \"time_zone\": \"America/Los_Angeles\"\n },\n \"battery\": 57,\n \"date_modified\": \"2020-09-05T20:19:21+00:00\",\n \"date_created\": \"2020-06-03T22:37:42+00:00\",\n \"is_online\": true,\n \"last_reading_date\": \"2022-11-08T23:06:02+00:00\",\n \"last_reading_value\": 75.434,\n \"placement\": {\n \"id\": 2,\n \"name\": \"Fridge\"\n },\n \"sensor_id\": \"0036BC0C0001F258\"\n }\n ]\n}"
}
},
"schema": {
"type": "object",
"properties": {
"meta": {
"type": "object",
"properties": {
"status_code": {
"type": "integer",
"example": 200,
"default": 0
},
"count": {
"type": "integer",
"example": 999,
"default": 0
},
"next": {
"type": "string",
"example": "https://www.zenput.com/api/v2/sensors/sensors/?limit=1&start=1"
},
"previous": {}
}
},
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"example": 42,
"default": 0
},
"name": {
"type": "string",
"example": "Fridge Sensor"
},
"account": {
"type": "object",
"properties": {
"id": {
"type": "string",
"example": "1"
},
"name": {
"type": "string",
"example": "Location name"
},
"time_zone": {
"type": "string",
"example": "America/Los_Angeles"
}
}
},
"battery": {
"type": "integer",
"example": 57,
"default": 0
},
"date_modified": {
"type": "string",
"example": "2020-09-05T20:19:21+00:00"
},
"date_created": {
"type": "string",
"example": "2020-06-03T22:37:42+00:00"
},
"is_online": {
"type": "boolean",
"example": true,
"default": true
},
"last_reading_date": {
"type": "string",
"example": "2022-11-08T23:06:02+00:00"
},
"last_reading_value": {
"type": "number",
"example": 75.434,
"default": 0
},
"placement": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"example": 2,
"default": 0
},
"name": {
"type": "string",
"example": "Fridge"
}
}
},
"sensor_id": {
"type": "string",
"example": "0036BC0C0001F258"
}
}
}
}
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": true,
"proxy-enabled": true
},
"x-readme-fauxas": true
}
```