> ## Documentation Index > Fetch the complete documentation index at: https://docs.assetinfinity.ai/llms.txt > Use this file to discover all available pages before exploring further. # List sensors > Sensors with their latest reading, open alerts, and whether they feed a meter. A sensor is on an asset or at a site, never both: asset_id for one fitted to a machine, site_id (and location_id) for one that measures a place. ## OpenAPI ````yaml /api-reference/integration.json get /sensors openapi: 3.0.0 info: description: >- The calls an integration needs first. Every endpoint the application uses is in the complete reference. title: Asset Infinity integration API version: 12.2.3 servers: - url: https://app.assetinfinity.ai/api security: [] tags: - description: >- Exchange an API key, or an email and password, for a short-lived session token, and send it as `Authorization: Bearer ` on every other call. name: Signing in - description: >- Where assets are and work happens. A location belongs to a site and may sit inside another location. name: Sites and locations - description: >- The asset register: read it, add to it, correct it, move an asset between sites and locations, and change its status. name: Assets - description: >- Report a problem. A request is triaged by a person, who turns it into a work order or turns it down. name: Work requests - description: >- Raise a job, give it to somebody, move it through the organisation's statuses, complete it and close it. name: Work orders - description: >- Send readings in. A meter reading brings the meter forward and raises any maintenance the usage has made due. A sensor reading can open or clear an alert. name: Meters and sensors - description: >- The part catalogue and what is on the shelf in each store, and the three movements an outside system most often records: a delivery in, an issue out and a correction. name: Parts and stock - description: >- Have the product call your system when something happens, instead of asking it on a timer. name: Webhooks - description: >- The calls behind every register that has no call of its own, answers to the organisation's own fields, and the two calls that answer what to send. `list_options` returns the ids a field accepts. `describe_call` returns the fields any call takes. name: Any record externalDocs: description: PostgREST Documentation url: https://postgrest.org/en/v12/references/api.html paths: /sensors: get: tags: - Meters and sensors summary: List sensors description: >- Sensors with their latest reading, open alerts, and whether they feed a meter. A sensor is on an asset or at a site, never both: asset_id for one fitted to a machine, site_id (and location_id) for one that measures a place. parameters: - $ref: '#/components/parameters/rowFilter.sensors.id' - $ref: '#/components/parameters/rowFilter.sensors.code' - $ref: '#/components/parameters/rowFilter.sensors.name' - $ref: '#/components/parameters/rowFilter.sensors.measurement' - $ref: '#/components/parameters/rowFilter.sensors.asset_id' - $ref: '#/components/parameters/rowFilter.sensors.asset_number' - $ref: '#/components/parameters/rowFilter.sensors.asset_name' - $ref: '#/components/parameters/rowFilter.sensors.site_id' - $ref: '#/components/parameters/rowFilter.sensors.site_code' - $ref: '#/components/parameters/rowFilter.sensors.site_name' - $ref: '#/components/parameters/rowFilter.sensors.location_id' - $ref: '#/components/parameters/rowFilter.sensors.location_name' - $ref: '#/components/parameters/rowFilter.sensors.device_id' - $ref: '#/components/parameters/rowFilter.sensors.device_code' - $ref: '#/components/parameters/rowFilter.sensors.device_status' - $ref: '#/components/parameters/rowFilter.sensors.meter_id' - $ref: '#/components/parameters/rowFilter.sensors.meter_code' - $ref: '#/components/parameters/rowFilter.sensors.meter_name' - $ref: '#/components/parameters/rowFilter.sensors.meter_sync_seconds' - $ref: '#/components/parameters/rowFilter.sensors.sample_interval_seconds' - $ref: '#/components/parameters/rowFilter.sensors.last_reading_at' - $ref: '#/components/parameters/rowFilter.sensors.last_meter_sync_at' - $ref: '#/components/parameters/rowFilter.sensors.is_active' - $ref: '#/components/parameters/rowFilter.sensors.feeds_maintenance' - $ref: '#/components/parameters/rowFilter.sensors.meter_feeders' - $ref: '#/components/parameters/rowFilter.sensors.thresholds' - $ref: '#/components/parameters/rowFilter.sensors.open_alerts' - $ref: '#/components/parameters/rowFilter.sensors.latest_value' - $ref: '#/components/parameters/select' - $ref: '#/components/parameters/order' - $ref: '#/components/parameters/range' - $ref: '#/components/parameters/rangeUnit' - $ref: '#/components/parameters/offset' - $ref: '#/components/parameters/limit' - $ref: '#/components/parameters/preferCount' responses: '200': content: application/json: schema: items: $ref: '#/components/schemas/sensors' type: array application/vnd.pgrst.object+json: schema: items: $ref: '#/components/schemas/sensors' type: array application/vnd.pgrst.object+json;nulls=stripped: schema: items: $ref: '#/components/schemas/sensors' type: array text/csv: schema: items: $ref: '#/components/schemas/sensors' type: array description: OK '206': description: Partial Content components: parameters: rowFilter.sensors.id: in: query name: id required: false schema: type: string rowFilter.sensors.code: in: query name: code required: false schema: type: string rowFilter.sensors.name: in: query name: name required: false schema: type: string rowFilter.sensors.measurement: in: query name: measurement required: false schema: type: string rowFilter.sensors.asset_id: in: query name: asset_id required: false schema: type: string rowFilter.sensors.asset_number: in: query name: asset_number required: false schema: type: string rowFilter.sensors.asset_name: in: query name: asset_name required: false schema: type: string rowFilter.sensors.site_id: in: query name: site_id required: false schema: type: string rowFilter.sensors.site_code: in: query name: site_code required: false schema: type: string rowFilter.sensors.site_name: in: query name: site_name required: false schema: type: string rowFilter.sensors.location_id: in: query name: location_id required: false schema: type: string rowFilter.sensors.location_name: in: query name: location_name required: false schema: type: string rowFilter.sensors.device_id: in: query name: device_id required: false schema: type: string rowFilter.sensors.device_code: in: query name: device_code required: false schema: type: string rowFilter.sensors.device_status: in: query name: device_status required: false schema: type: string rowFilter.sensors.meter_id: in: query name: meter_id required: false schema: type: string rowFilter.sensors.meter_code: in: query name: meter_code required: false schema: type: string rowFilter.sensors.meter_name: in: query name: meter_name required: false schema: type: string rowFilter.sensors.meter_sync_seconds: in: query name: meter_sync_seconds required: false schema: type: string rowFilter.sensors.sample_interval_seconds: in: query name: sample_interval_seconds required: false schema: type: string rowFilter.sensors.last_reading_at: in: query name: last_reading_at required: false schema: type: string rowFilter.sensors.last_meter_sync_at: in: query name: last_meter_sync_at required: false schema: type: string rowFilter.sensors.is_active: in: query name: is_active required: false schema: type: string rowFilter.sensors.feeds_maintenance: in: query name: feeds_maintenance required: false schema: type: string rowFilter.sensors.meter_feeders: in: query name: meter_feeders required: false schema: type: string rowFilter.sensors.thresholds: in: query name: thresholds required: false schema: type: string rowFilter.sensors.open_alerts: in: query name: open_alerts required: false schema: type: string rowFilter.sensors.latest_value: in: query name: latest_value required: false schema: type: string select: description: Filtering Columns in: query name: select required: false schema: type: string order: description: Ordering in: query name: order required: false schema: type: string range: description: Limiting and Pagination in: header name: Range required: false schema: type: string rangeUnit: description: Limiting and Pagination in: header name: Range-Unit required: false schema: default: items type: string offset: description: Limiting and Pagination in: query name: offset required: false schema: type: string limit: description: Limiting and Pagination in: query name: limit required: false schema: type: string preferCount: description: Preference in: header name: Prefer required: false schema: enum: - count=none type: string schemas: sensors: description: >- Sensors with their latest reading, open alerts, and whether they feed a meter. A sensor is on an asset or at a site, never both: asset_id for one fitted to a machine, site_id (and location_id) for one that measures a place. properties: asset_id: description: >- Note: This is a Foreign Key to `asset_contracts.asset_id`. format: uuid type: string asset_name: format: character varying maxLength: 250 type: string asset_number: format: character varying maxLength: 80 type: string code: format: character varying maxLength: 60 type: string device_code: format: character varying maxLength: 60 type: string device_id: format: uuid type: string device_status: format: character varying maxLength: 20 type: string feeds_maintenance: format: boolean type: boolean id: description: |- Note: This is a Primary Key. format: uuid type: string is_active: format: boolean type: boolean last_meter_sync_at: format: timestamp with time zone type: string last_reading_at: format: timestamp with time zone type: string latest_value: format: numeric type: number location_id: description: >- Note: This is a Foreign Key to `location_settings.id`. format: uuid type: string location_name: format: character varying maxLength: 200 type: string measurement: format: character varying maxLength: 30 type: string meter_code: format: character varying maxLength: 60 type: string meter_feeders: format: bigint type: integer meter_id: description: >- Note: This is a Foreign Key to `asset_meters.meter_id`. format: uuid type: string meter_name: format: character varying maxLength: 150 type: string meter_sync_seconds: format: integer type: integer name: format: character varying maxLength: 150 type: string open_alerts: format: bigint type: integer sample_interval_seconds: format: integer type: integer site_code: format: character varying maxLength: 50 type: string site_id: description: >- Note: This is a Foreign Key to `entry_currencies.for_site_id`. format: uuid type: string site_name: format: character varying maxLength: 200 type: string thresholds: format: bigint type: integer type: object ```` This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.