{"openapi":"3.0.1","info":{"title":"Devices","description":"Devices","version":"v3"},"servers":[{"url":"https://talk.perspio.io/devices/v3","description":"AU Region"},{"url":"https://us-talk.perspio.io/devices/v3","description":"US Region"}],"paths":{"/{id}":{"patch":{"tags":["Devices"],"summary":"Update Device","description":"Apply a partial update to a single device by id.","operationId":"updatedevice","parameters":[{"name":"id","in":"path","description":"Device Id","required":true,"schema":{"type":"string","example":"DM-12345"}},{"name":"includedisabledassets","in":"header","description":"When true, disabled devices are included in the tenant scope applied to this request. Defaults to false.","schema":{"type":"boolean"},"example":"False"}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateDevice-RequestObject"},"example":[{"value":100,"path":"/runHoursOffset","op":"replace"},{"value":-100,"path":"/odometerOffset","op":"replace"}]}}},"responses":{"200":{"description":"The device was updated."},"400":{"description":"Invalid Request"},"401":{"description":"Invalid API Key provided or Invalid Access token"},"404":{"description":"Device Not Found"},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerspioError"},"example":{"functionName":"Perspio.API.Devices.DeviceDetailsApi.UpdateDeviceDetails","errorType":"NullReferenceException","statusCode":500,"request":"PATCH /api/devicesV2/DM-12345","tenantId":"in-93b1a4c6-1234-4c1c-9d2a-1f2e3d4c5b6a","message":"Internal Server Error: Object reference not set to an instance of an object."}}}}}},"get":{"tags":["Devices"],"summary":"Get Device","description":"Fetch the current snapshot of a single device by id - its master record merged with its latest reported state.","operationId":"getDevice","parameters":[{"name":"id","in":"path","description":"Device Id","required":true,"schema":{"type":"string","example":"DM-12345"}},{"name":"includedisabledassets","in":"header","description":"When true, disabled devices are included in the tenant scope applied to this request. Defaults to false.","schema":{"type":"boolean"},"example":"False"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"ignition":{"type":"boolean"},"vehicleActive":{"type":"boolean"},"externalBatteryVoltage":{"type":"number"},"crankingVoltage":{"type":"number"},"engineRoadSpeed":{"type":"number"},"speed":{"type":"number"},"engineCoolantTemp":{"type":"number"},"engineOilTemp":{},"outsideAirTemp":{},"totalFuel":{"type":"number"},"engineSpeed":{"type":"number"},"parkingBrake":{"type":"boolean"},"fuelLevelPct":{},"fuelTankCapacity":{},"driverId":{},"geotabTelemetryType":{},"ioxcan":{},"temperature1":{},"temperature2":{},"temperature3":{},"temperature4":{},"contactSensor1":{"type":"boolean"},"contactSensor2":{"type":"boolean"},"standardHarnessDetected":{"type":"boolean"},"engineDataActive":{"type":"boolean"},"mSCAN125kProtocol":{"type":"boolean"},"intelligentHarnessType":{"type":"number"},"iOXCAN500kProtocol":{"type":"boolean"},"cellularModemSignalStrength":{"type":"number"},"engineOBD2PIDCount":{"type":"number"},"didcomTPM":{"type":"boolean"},"vehicleIdentificationNumber":{"type":"string"},"cITMode":{"type":"boolean"},"valetMode":{"type":"boolean"},"deviceId":{"type":"string","description":"Unique device identifier."},"deviceTypeId":{"type":"number","description":"Identifier of the device type (its schema)."},"pipelineId":{"type":"string","description":"Id of the ingestion pipeline feeding this device."},"enabled":{"type":"boolean"},"heading":{"type":"number","description":"Last reported heading, in degrees."},"serial":{"description":"Device serial number."},"sequenceNo":{},"hubEnqueuedTimeUtc":{"type":"string"},"odometer":{"type":"number"},"odometerRaw":{"type":"number"},"odometerOffset":{},"odometerSource":{"type":"number"},"runHours":{"type":"number"},"runHoursRaw":{},"runHoursOffset":{},"runHoursSource":{"type":"number"},"insideGeofenceJson":{},"mirroredTenantIds":{"type":"array","items":{}},"mirroredTenantIdsJson":{"type":"string"},"id":{"type":"string","description":"Unique identifier of this record."},"tenantId":{"type":"string","description":"Identifier of the owning tenant."},"active":{"type":"boolean","description":"Whether the device is currently active/enabled."},"latitude":{"type":"number","description":"Latitude of the last known position."},"longitude":{"type":"number","description":"Longitude of the last known position."},"coordinates":{"type":"string","description":"Coordinate array defining the position ([lon, lat] order)."},"lastCommunicatedUtc":{"type":"string","description":"UTC timestamp of the device's most recent communication."},"lastCommunicatedEpoch":{"type":"number"},"correlationId":{"type":"string","description":"Client-supplied correlation id, echoed back for request tracing."},"_ts":{"type":"number"},"createdBy":{"type":"string","description":"User or system that created the record."},"createdDate":{"type":"string","description":"UTC timestamp when the record was created."},"updatedBy":{"type":"string","description":"User or system that last modified the record."},"ownedBy":{},"updatedDate":{"type":"string","description":"UTC timestamp when the record was last modified."},"deviceInfo":{"type":"object","properties":{"deviceTypeId":{"type":"number","description":"Identifier of the device type (its schema)."},"perspioDeviceId":{"type":"number"},"perspioPipelineId":{"type":"string"},"serial":{"type":"string","description":"Device serial number."},"imei":{"type":"string"},"uuid":{},"euid":{},"mac":{},"iccid":{"type":"string"},"vendorInternalId":{"type":"string"},"vendorTenantName":{"type":"string"},"simInfo":{"type":"object","properties":{"vendor":{},"imsi":{},"msisdn":{},"status":{},"ratePlan":{},"communicationPlan":{},"customer":{},"dateActivated":{},"dateAdded":{},"dateUpdated":{},"dateShipped":{},"accountId":{},"fixedIPAddress":{},"notes":{},"euiccid":{},"deviceID":{"description":"Unique device identifier."},"modemID":{},"dataUsage":{},"sessionCount":{},"limitReached":{},"limitOverride":{}}},"comment":{},"isActive":{"type":"boolean"},"enabled":{"type":"boolean"},"historyEnabled":{"type":"boolean"},"managedBy":{"type":"string"},"odometerOffset":{},"runHoursOffset":{},"mapping":{}},"description":"Descriptive device metadata (name and related details)."}}},"example":{"ignition":true,"vehicleActive":true,"externalBatteryVoltage":12.6,"crankingVoltage":11.9,"engineRoadSpeed":60,"speed":58,"engineCoolantTemp":90,"engineOilTemp":85,"outsideAirTemp":25,"totalFuel":50,"engineSpeed":2000,"parkingBrake":false,"fuelLevelPct":65,"fuelTankCapacity":100,"driverId":"driver-123","geotabTelemetryType":"vehicle","ioxcan":"enabled","temperature1":22,"temperature2":23,"temperature3":24,"temperature4":25,"contactSensor1":true,"contactSensor2":false,"standardHarnessDetected":true,"engineDataActive":true,"mSCAN125kProtocol":false,"intelligentHarnessType":1,"iOXCAN500kProtocol":true,"cellularModemSignalStrength":-65,"engineOBD2PIDCount":10,"didcomTPM":false,"vehicleIdentificationNumber":"1HGCM82633A004352","cITMode":false,"valetMode":false,"deviceId":"device-abc-123","deviceTypeId":101,"pipelineId":"pipeline-xyz","enabled":true,"heading":180,"serial":"serial-001","sequenceNo":1001,"hubEnqueuedTimeUtc":"2024-06-25T12:00:00.0000000+00:00","odometer":120345,"odometerRaw":120000,"odometerOffset":345,"odometerSource":2,"runHours":5000,"runHoursRaw":4950,"runHoursOffset":50,"runHoursSource":1,"insideGeofenceJson":"{\"geofenceId\": \"gf-123\"}","mirroredTenantIds":["tenant-1","tenant-2"],"mirroredTenantIdsJson":"[\"tenant-1\", \"tenant-2\"]","id":"dev-000807","tenantId":"tenant-xyz","active":true,"latitude":-33.865143,"longitude":151.2099,"coordinates":"-33.865143,151.2099","lastCommunicatedUtc":"2024-06-25T11:59:00.0000000+00:00","lastCommunicatedEpoch":1721907540,"correlationId":"corr-789","_ts":1721907540,"createdBy":"system","createdDate":"2024-06-25T10:00:00.0000000+00:00","updatedBy":"system","ownedBy":"team-operations","updatedDate":"2024-06-25T11:00:00.0000000+00:00","deviceInfo":{"deviceTypeId":101,"perspioDeviceId":555,"perspioPipelineId":"pipeline-xyz","serial":"serial-001","imei":"123456789012345","uuid":"uuid-1234","euid":"euid-5678","mac":"00:1A:2B:3C:4D:5E","iccid":"8901120200000000000","vendorInternalId":"vendor-001","vendorTenantName":"vendor-tenant","simInfo":{"vendor":"Telstra","imsi":"505012345678901","msisdn":"61412345678","status":"active","ratePlan":"standard","communicationPlan":"basic","customer":"customer-001","dateActivated":"2024-01-01","dateAdded":"2024-01-02","dateUpdated":"2024-06-01","dateShipped":"2023-12-20","accountId":"account-999","fixedIPAddress":"192.0.2.1","notes":"Test SIM","euiccid":"8901120200000000000","deviceID":"device-abc-123","modemID":"modem-555","dataUsage":1024,"sessionCount":10,"limitReached":false,"limitOverride":false},"comment":"Device in service","isActive":true,"enabled":true,"historyEnabled":true,"managedBy":"operations-team","odometerOffset":345,"runHoursOffset":50,"mapping":{}}}}}},"400":{"description":"Invalid Request"},"401":{"description":"Invalid API Key provided or Invalid Access token"},"404":{"description":"Device Not Found"},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerspioError"},"example":{"functionName":"Perspio.API.Devices.DeviceDetailsApi.GetDeviceSnapshotById","errorType":"NullReferenceException","statusCode":500,"request":"GET /api/devicesV2/DM-12345","tenantId":"in-93b1a4c6-1234-4c1c-9d2a-1f2e3d4c5b6a","message":"Internal Server Error: Object reference not set to an instance of an object."}}}}}}},"/{id}/history":{"get":{"tags":["Devices"],"summary":"Get Device History","description":"Fetch history data of a device. When page_size > 0 the response is paged - it returns a {key, value} envelope (key = the continuation token, value = the array of history records) plus the ContinuationToken/ResultCount/TotalCount headers; otherwise the full array is returned.","operationId":"getdevicehistory","parameters":[{"name":"id","in":"path","description":"Device Id","required":true,"schema":{"type":"string","example":"DM-12345"}},{"name":"from","in":"query","description":"Start time in ISO 8601 format","required":true,"schema":{"type":"string","format":"date-time"},"example":"2024-06-16T02:00:00.0000000+00:00"},{"name":"to","in":"query","description":"End time in ISO 8601 format","required":true,"schema":{"type":"string","format":"date-time"},"example":"2024-06-17T01:59:59.0000000+00:00"},{"name":"page_size","in":"query","description":"Number of events to return per page","schema":{"type":"integer","format":"int32"},"example":50},{"name":"includedisabledassets","in":"header","description":"When true, disabled devices are included in the tenant scope applied to this request. Defaults to false.","schema":{"type":"boolean"},"example":"False"},{"name":"ContinuationToken","in":"header","description":"Continuation token from the previous response's ContinuationToken header, used to fetch the next page.","schema":{"type":"string"},"example":"eyJ0b2tlbiI6IjEwMDAifQ=="}],"responses":{"200":{"description":"Success","headers":{"ContinuationToken":{"description":"Token to pass back (as the ContinuationToken header) to fetch the next page; absent on the last page.","schema":{"type":"string"},"example":"eyJ0b2tlbiI6IjEwMDAifQ=="},"ResultCount":{"description":"Number of items returned in this page.","schema":{"type":"integer","format":"int64"},"example":50},"TotalCount":{"description":"Total number of items matching the request across all pages.","schema":{"type":"integer","format":"int64"},"example":1372}},"content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","description":"Opaque continuation token; pass it back as the ContinuationToken header to fetch the next page."},"sourceTimeStamp":{"type":"string","format":"date-time","nullable":true},"value":{"type":"object","description":"Page of result records."}}}},"example":[{"key":"temperature","sourceTimeStamp":"2025-07-02T10:30:00.0000000+00:00","value":{"reading":25.5,"unit":"Celsius"}},{"key":"humidity","sourceTimeStamp":null,"value":{"reading":60,"unit":"%"}},{"key":"pressure","sourceTimeStamp":"2025-07-02T10:31:00.0000000+00:00","value":{"reading":1013.25,"unit":"hPa"}}]}}},"400":{"description":"Invalid Request"},"401":{"description":"Invalid API Key provided or Invalid Access token"},"404":{"description":"Device Not Found"},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerspioError"},"example":{"functionName":"Perspio.API.Devices.DeviceDetailsApi.GetDeviceHistory","errorType":"NullReferenceException","statusCode":500,"request":"GET /api/devicesV2/DM-12345/history","tenantId":"in-93b1a4c6-1234-4c1c-9d2a-1f2e3d4c5b6a","message":"Internal Server Error: Object reference not set to an instance of an object."}}}}}}},"/{id}/metrics":{"get":{"tags":["Telemetry"],"summary":"Get Device Metrics","description":"Fetch metrics of a device.","operationId":"getdevicemetrics","parameters":[{"name":"id","in":"path","description":"Device Id","required":true,"schema":{"type":"string","example":"DM-12345"}},{"name":"from","in":"query","description":"Start time in ISO 8601 format","required":true,"schema":{"type":"string","format":"date-time","example":"2024-06-16T02:00:00.0000000+00:00"}},{"name":"to","in":"query","description":"End time in ISO 8601 format","required":true,"schema":{"type":"string","format":"date-time","example":"2024-06-20T01:59:59.0000000+00:00"}},{"name":"metrics","in":"query","description":"Comma-separated list of metrics to retrieve","schema":{"type":"string"},"example":"hubEnqueuedTimeUtc,lastCommunicatedUtc"},{"name":"latestState","in":"query","description":"If true, retrieves the record with latest state, irrespective of the from and to time range. Default is true.","schema":{"type":"string"},"example":true},{"name":"includedisabledassets","in":"header","description":"When true, disabled devices are included in the tenant scope applied to this request. Defaults to false.","schema":{"type":"boolean"},"example":"False"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"$ref":"#/components/schemas/DeviceMetrics"},"example":{"timeZone":[{"ts":"2025-01-15T04:39:41.0000000+00:00","val":"Central Standard Time","pipelineId":"ic-000006"}],"speed":[{"ts":"2025-01-16T05:10:49.0000000+00:00","val":"0.0","pipelineId":"ic-000006"}],"preferredRunHours":[{"ts":"2025-01-16T05:40:04.0000000+00:00","val":"0.86","pipelineId":"PerspioMeterTrigger"}],"preferredOdometer":[{"ts":"2025-01-16T02:05:16.0000000+00:00","val":"0","pipelineId":"PerspioMeterTrigger"}],"perspioRunHours":[{"ts":"2025-01-16T05:40:04.0000000+00:00","val":"0.86","pipelineId":"PerspioMeterTrigger"}],"perspioOdometer":[{"ts":"2025-01-16T02:05:16.0000000+00:00","val":"0","pipelineId":"PerspioMeterTrigger"}],"longitude":[{"ts":"2025-01-16T05:10:49.0000000+00:00","val":"-94.69159","pipelineId":"ic-000006"}],"latitude":[{"ts":"2025-01-16T05:10:49.0000000+00:00","val":"38.9479","pipelineId":"ic-000006"}],"internalBatteryVoltage":[{"ts":"2025-01-15T11:05:08.0000000+00:00","val":"0027-05-01T12:00:00.0000000+00:00","pipelineId":"ic-000006"}],"coordinates":[{"ts":"2025-01-16T05:10:49.0000000+00:00","val":"38.9479,-94.69159","pipelineId":"ic-000006"}],"altitude":[{"ts":"2025-01-16T05:10:49.0000000+00:00","val":"423.0","pipelineId":"ic-000006"}],"active":[{"ts":"2025-01-16T05:17:34.0000000+00:00","val":"False","pipelineId":"ic-000006"}]}}}},"400":{"description":"Invalid Request"},"401":{"description":"Invalid API Key provided or Invalid Access token"},"404":{"description":"Device Not Found"},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerspioError"},"example":{"functionName":"Perspio.API.Devices.DeviceDetailsApi.GetDeviceMetrics","errorType":"NullReferenceException","statusCode":500,"request":"GET /api/devicesV2/DM-12345/metrics","tenantId":"in-93b1a4c6-1234-4c1c-9d2a-1f2e3d4c5b6a","message":"Internal Server Error: Object reference not set to an instance of an object."}}}}}}},"/{id}/metadata":{"get":{"tags":["Metadata"],"summary":"Get Device Metadata","description":"Fetch metadata and info of a device.","operationId":"getdevicewithmetadatainfo","parameters":[{"name":"id","in":"path","description":"Device Id","required":true,"schema":{"type":"string","example":"DM-12345"}},{"name":"includedisabledassets","in":"header","description":"When true, disabled devices are included in the tenant scope applied to this request. Defaults to false.","schema":{"type":"boolean"},"example":"False"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"correlationId":{"type":"string","description":"Client-supplied correlation id, echoed back for request tracing."},"createdBy":{"type":"string","description":"User or system that created the record."},"createdDate":{"type":"string","description":"UTC timestamp when the record was created.","format":"date-time"},"deviceInfo":{"type":"object","properties":{"comment":{"type":"string"},"deviceTypeId":{"type":"integer","description":"Identifier of the device type (its schema).","format":"int32"},"euid":{"type":"string"},"iccid":{"type":"string"},"imei":{"type":"string"},"isActive":{"type":"boolean"},"mac":{"type":"string"},"managedBy":{"type":"string"},"perspioDeviceId":{"type":"integer","format":"int32"},"perspioPipelineId":{"type":"string"},"perspioPipelineInstanceId":{"type":"string"},"serial":{"type":"string","description":"Device serial number."},"simInfo":{"type":"object","properties":{"accountId":{"type":"string"},"communicationPlan":{"type":"string"},"customer":{"type":"string"},"dataUsage":{"type":"integer","format":"int32","nullable":true},"dateActivated":{"type":"string","format":"date-time","nullable":true},"dateAdded":{"type":"string","format":"date-time","nullable":true},"dateShipped":{"type":"string","format":"date-time","nullable":true},"dateUpdated":{"type":"string","format":"date-time","nullable":true},"deviceID":{"type":"string","description":"Unique device identifier."},"euiccid":{"type":"string"},"fixedIPAddress":{"type":"string"},"imsi":{"type":"string"},"limitOverride":{"type":"string"},"limitReached":{"type":"boolean","nullable":true},"modemID":{"type":"string"},"msisdn":{"type":"string"},"notes":{"type":"string"},"ratePlan":{"type":"string"},"sessionCount":{"type":"integer","format":"int32","nullable":true},"status":{"type":"string"},"vendor":{"type":"string"}}},"uuid":{"type":"string"},"vendorInternalId":{"type":"string"},"vendorTenantName":{"type":"string"}},"description":"Descriptive device metadata (name and related details)."},"DeviceMetadata":{"type":"object","properties":{"bluetooth":{"type":"boolean"},"cellular":{"type":"boolean"},"correlationId":{"type":"string","description":"Client-supplied correlation id, echoed back for request tracing."},"externalLink":{"type":"string"},"gps":{"type":"boolean"},"id":{"type":"string","description":"Unique identifier of this record."},"loRa":{"type":"boolean"},"loRaWan":{"type":"boolean"},"make":{"type":"string"},"model":{"type":"string","description":"Device model."},"type":{"type":"string"},"serial":{"type":"boolean","description":"Device serial number."},"sigfox":{"type":"boolean"},"wifi":{"type":"boolean"}}},"deviceStatus":{"type":"object","description":"Lifecycle status of the device."},"id":{"type":"string","description":"Unique identifier of this record."},"mirroredTenantIds":{"type":"array","items":{"type":"string"}},"ownedBy":{"type":"string"},"type":{"type":"string"},"sourceDeviceId":{"type":"string","description":"Native device id from the originating source system."},"tenantId":{"type":"string","description":"Identifier of the owning tenant."},"updatedBy":{"type":"string","description":"User or system that last modified the record."},"updatedDate":{"type":"string","description":"UTC timestamp when the record was last modified.","format":"date-time"}}},"example":{"correlationId":"DM-000123","createdBy":"createdBy","createdDate":"2022-10-21T02:27:18.0000000+00:00","deviceInfo":{"comment":"comment","deviceTypeId":0,"euid":"DM-000123","iccid":"DM-000123","imei":"imei","isActive":false,"mac":"mac","managedBy":"managedBy","perspioDeviceId":0,"perspioPipelineId":"DM-000123","perspioPipelineInstanceId":"DM-000123","serial":"SN-44821","simInfo":{"accountId":"DM-000123","communicationPlan":"communicationPlan","customer":"customer","dataUsage":null,"dateActivated":null,"dateAdded":null,"dateShipped":null,"dateUpdated":null,"deviceID":"DM-000123","euiccid":"DM-000123","fixedIPAddress":"fixedIPAddress","imsi":"imsi","limitOverride":"DM-000123","limitReached":false,"modemID":"DM-000123","msisdn":"msisdn","notes":"notes","ratePlan":"ratePlan","sessionCount":null,"status":"active","vendor":"vendor"},"uuid":"DM-000123","vendorInternalId":"DM-000123","vendorTenantName":"Depot scanner 12"},"DeviceMetadata":{"bluetooth":false,"cellular":false,"correlationId":"DM-000123","externalLink":"externalLink","gps":false,"id":"DM-000123","loRa":false,"loRaWan":false,"make":"make","model":"PX-200","type":"gateway","serial":false,"sigfox":false,"wifi":false},"deviceStatus":{},"id":"DM-000123","mirroredTenantIds":["in-000052"],"ownedBy":"ownedBy","type":"gateway","sourceDeviceId":"DM-000123","tenantId":"DM-000123","updatedBy":"2026-06-28T10:00:00.0000000+00:00","updatedDate":"2022-10-21T02:27:18.0000000+00:00"}}}},"400":{"description":"Invalid Request"},"401":{"description":"Invalid API Key provided or Invalid Access token"},"404":{"description":"Device Not Found"},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerspioError"},"example":{"functionName":"Perspio.API.Devices.DevicesApi.GetDeviceWithMetadataInfo","errorType":"NullReferenceException","statusCode":500,"request":"GET /api/DM-12345/metadata","tenantId":"in-93b1a4c6-1234-4c1c-9d2a-1f2e3d4c5b6a","message":"Internal Server Error: Object reference not set to an instance of an object."}}}}}}},"/{id}/info":{"get":{"tags":["Metadata"],"summary":"Get Device Info","description":"Fetch the descriptive information for a single device by id.","operationId":"getdeviceinfo","parameters":[{"name":"id","in":"path","description":"Device Id","required":true,"schema":{"type":"string","example":"DM-12345"}},{"name":"includedisabledassets","in":"header","description":"When true, disabled devices are included in the tenant scope applied to this request. Defaults to false.","schema":{"type":"boolean"},"example":"False"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"object","properties":{"correlationId":{"type":"string","description":"Client-supplied correlation id, echoed back for request tracing."},"createdBy":{"type":"string","description":"User or system that created the record."},"createdDate":{"type":"string","description":"UTC timestamp when the record was created.","format":"date-time"},"deviceInfo":{"type":"object","properties":{"comment":{"type":"string"},"deviceTypeId":{"type":"integer","description":"Identifier of the device type (its schema).","format":"int32"},"euid":{"type":"string"},"iccid":{"type":"string"},"imei":{"type":"string"},"isActive":{"type":"boolean"},"mac":{"type":"string"},"managedBy":{"type":"string"},"perspioDeviceId":{"type":"integer","format":"int32"},"perspioPipelineId":{"type":"string"},"perspioPipelineInstanceId":{"type":"string"},"serial":{"type":"string","description":"Device serial number."},"simInfo":{"type":"object","properties":{"accountId":{"type":"string"},"communicationPlan":{"type":"string"},"customer":{"type":"string"},"dataUsage":{"type":"integer","format":"int32","nullable":true},"dateActivated":{"type":"string","format":"date-time","nullable":true},"dateAdded":{"type":"string","format":"date-time","nullable":true},"dateShipped":{"type":"string","format":"date-time","nullable":true},"dateUpdated":{"type":"string","format":"date-time","nullable":true},"deviceID":{"type":"string","description":"Unique device identifier."},"euiccid":{"type":"string"},"fixedIPAddress":{"type":"string"},"imsi":{"type":"string"},"limitOverride":{"type":"string"},"limitReached":{"type":"boolean","nullable":true},"modemID":{"type":"string"},"msisdn":{"type":"string"},"notes":{"type":"string"},"ratePlan":{"type":"string"},"sessionCount":{"type":"integer","format":"int32","nullable":true},"status":{"type":"string"},"vendor":{"type":"string"}}},"uuid":{"type":"string"},"vendorInternalId":{"type":"string"},"vendorTenantName":{"type":"string"}},"description":"Descriptive device metadata (name and related details)."},"deviceStatus":{"type":"object","description":"Lifecycle status of the device."},"id":{"type":"string","description":"Unique identifier of this record."},"mirroredTenantIds":{"type":"array","items":{"type":"string"}},"ownedBy":{"type":"string"},"type":{"type":"string"},"sourceDeviceId":{"type":"string","description":"Native device id from the originating source system."},"tenantId":{"type":"string","description":"Identifier of the owning tenant."},"updatedBy":{"type":"string","description":"User or system that last modified the record."},"updatedDate":{"type":"string","description":"UTC timestamp when the record was last modified.","format":"date-time"}}},"example":{"correlationId":"DM-000123","createdBy":"createdBy","createdDate":"2022-10-21T02:27:18.0000000+00:00","deviceInfo":{"comment":"comment","deviceTypeId":0,"euid":"DM-000123","iccid":"DM-000123","imei":"imei","isActive":false,"mac":"mac","managedBy":"managedBy","perspioDeviceId":0,"perspioPipelineId":"DM-000123","perspioPipelineInstanceId":"DM-000123","serial":"SN-44821","simInfo":{"accountId":"DM-000123","communicationPlan":"communicationPlan","customer":"customer","dataUsage":null,"dateActivated":null,"dateAdded":null,"dateShipped":null,"dateUpdated":null,"deviceID":"DM-000123","euiccid":"DM-000123","fixedIPAddress":"fixedIPAddress","imsi":"imsi","limitOverride":"DM-000123","limitReached":false,"modemID":"DM-000123","msisdn":"msisdn","notes":"notes","ratePlan":"ratePlan","sessionCount":null,"status":"active","vendor":"vendor"},"uuid":"DM-000123","vendorInternalId":"DM-000123","vendorTenantName":"Depot scanner 12"},"deviceStatus":{},"id":"DM-000123","mirroredTenantIds":["in-000052"],"ownedBy":"ownedBy","type":"gateway","sourceDeviceId":"DM-000123","tenantId":"DM-000123","updatedBy":"2026-06-28T10:00:00.0000000+00:00","updatedDate":"2022-10-21T02:27:18.0000000+00:00"}}}},"400":{"description":"Invalid Request"},"401":{"description":"Invalid API Key provided or Invalid Access token"},"404":{"description":"Device Not Found"},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerspioError"},"example":{"functionName":"Perspio.API.Devices.DevicesApi.GetDeviceInfo","errorType":"NullReferenceException","statusCode":500,"request":"GET /api/DM-12345/info","tenantId":"in-93b1a4c6-1234-4c1c-9d2a-1f2e3d4c5b6a","message":"Internal Server Error: Object reference not set to an instance of an object."}}}}}}},"/":{"get":{"tags":["Devices"],"summary":"Get Devices","description":"List the tenant's devices. Returns a summary projection; when alldata=true the full device record is returned for each device.","operationId":"getDevices","parameters":[{"name":"alldata","in":"query","description":"When true, return the full device record; otherwise a lighter summary projection.","schema":{"type":"boolean"},"example":"False"},{"name":"includedisabledassets","in":"header","description":"When true, disabled devices are included in the tenant scope applied to this request. Defaults to false.","schema":{"type":"boolean"},"example":"False"}],"responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"correlationId":{"type":"string","description":"Client-supplied correlation id, echoed back for request tracing."},"ExtraProperties":{"type":"object"},"id":{"type":"string","description":"Unique identifier of this record."},"Item":{"type":"object"},"tenantId":{"type":"string","description":"Identifier of the owning tenant."},"Ts":{"type":"integer","description":"Store timestamp (Unix epoch seconds) of the last write.","format":"int64"},"TwinMetadata":{"type":"object","properties":{"LastUpdateTimes":{"type":"object"},"modelId":{"type":"string"}}}}}},"example":[{"correlationId":"abc123-correlation","ExtraProperties":{"source":"sensor","location":"warehouse-1"},"id":"event-0001","Item":{"temperature":24.5,"humidity":60},"tenantId":"in-tenant-001","Ts":1720189200000,"TwinMetadata":{"LastUpdateTimes":{"temperature":"2025-07-02T10:30:00.0000000+00:00","humidity":"2025-07-02T10:35:00.0000000+00:00"},"modelId":"dtmi:inauro:sensor;1"}},{"correlationId":"def456-correlation","ExtraProperties":{"source":"gateway","location":"warehouse-2"},"id":"event-0002","Item":{"pressure":1013.25,"status":"nominal"},"tenantId":"in-tenant-002","Ts":1720189260000,"TwinMetadata":{"LastUpdateTimes":{"pressure":"2025-07-02T10:40:00.0000000+00:00"},"modelId":"dtmi:inauro:gateway;1"}}]}}},"400":{"description":"Invalid Request"},"401":{"description":"Invalid API Key provided or Invalid Access token"},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerspioError"},"example":{"functionName":"Perspio.API.Devices.DeviceDetailsApi.GetDevices","errorType":"NullReferenceException","statusCode":500,"request":"GET /api/devicesV2","tenantId":"in-93b1a4c6-1234-4c1c-9d2a-1f2e3d4c5b6a","message":"Internal Server Error: Object reference not set to an instance of an object."}}}}}}},"/types":{"get":{"tags":["Devices"],"summary":"Get Device Types","description":"List the available device types and their property schemas.","operationId":"getDeviceTypes","responses":{"200":{"description":"Success","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"deviceTypeId":{"type":"number","description":"Identifier of the device type (its schema)."},"deviceTypeName":{"type":"string"},"schema":{"type":"array","items":{"type":"object","properties":{"modelId":{"type":"string"},"propertyName":{"type":"string"},"propertyTitle":{"type":"string"},"propertyType":{"type":"string"},"valueType":{"type":"string"}}},"description":"JSON schema describing the device type properties."},"uiSchema":{"type":"object","properties":{"deviceTypeId":{"type":"number","description":"Identifier of the device type (its schema)."},"deviceTypeName":{"type":"string"},"deviceTypeDisplayName":{"type":"string"},"schema":{"type":"object","properties":{"deviceId":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object","properties":{"position":{"type":"number"}}}}}},"description":"Unique device identifier."},"serial":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object","properties":{"position":{"type":"number"}}}}}},"description":"Device serial number."},"deviceTypeId":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object","properties":{"position":{"type":"number"}}}}}},"description":"Identifier of the device type (its schema)."},"pipelineId":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object","properties":{"position":{"type":"number"}}}}}},"description":"Id of the ingestion pipeline feeding this device."},"createdDate":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object","properties":{"position":{"type":"number"}}}}}},"description":"UTC timestamp when the record was created."},"imei":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"iccid":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"productId":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"firmware":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"hubEnqueuedTimeUtc":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"lastCommunicatedUtc":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}},"description":"UTC timestamp of the device's most recent communication."},"gpsUtc":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"reason":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"gpsStat":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"pdop":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"posAcc":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"internalBatteryVoltage":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{"type":"string"}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"vBattGood":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"vExtEnabled":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"boolLabels":{"type":"array","items":{"type":"string"}},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"vExtGood":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"temp":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{"type":"string"}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"lastKnownGsmcq":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"connectedToGsm":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"inTrip":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"shuntingPowerfromBatt":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"vehicleIdentificationNumber":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"geotabTelemetryType":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"externalBatteryVoltage":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{"type":"string"}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"standardHarnessDetected":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"boolLabels":{"type":"array","items":{"type":"string"}},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"engineDataActive":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"boolLabels":{"type":"array","items":{"type":"string"}},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"mSCAN125kProtocol":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"boolLabels":{"type":"array","items":{"type":"string"}},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"intelligentHarnessType":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"ioxcan":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"iOXCAN500kProtocol":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"boolLabels":{"type":"array","items":{"type":"string"}},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"cellularModemSignalStrength":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{"type":"string"}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"engineOBD2PIDCount":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{"type":"string"}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"didcomTPM":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"boolLabels":{"type":"array","items":{"type":"string"}},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"vehicleId":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"vehicleName":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"gpsLocked":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"boolLabels":{"type":"array","items":{"type":"string"}},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"status":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"lastCommunicatedEpoch":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object"}}},"model":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}},"description":"Device model."},"uninitialised":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"label":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"phasesCount":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"commsType":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"signalQualityDbm":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"simId":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"apn":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"imsi":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"networkId":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"gsmLevel":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"gsmSignalQuality":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"gpsSignalQuality":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"internalBatteryPtc":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"serialNo":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"rssi":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}},"staticSection":{"type":"object"}}}}},"snr":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}},"staticSection":{"type":"object"}}}}},"wifiRssi":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"wifiIp":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"gpsValid":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"hdop":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"numSatellites":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"communicationChannel":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"outOfOrder":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"gpsAcc":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object"}}}}},"voltage":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{"type":"string"}},"display":{"type":"object","properties":{"metricSection":{"type":"object"}}}}},"lastWakeAttempt":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"deviceModel":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"staticSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"bandwidth":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"frequency":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"spreadFactor":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}},"frameCount":{"type":"object","properties":{"field":{"type":"string"},"type":{"type":"string"},"unit":{"type":"string"},"name":{"type":"string","description":"Display name."},"icon":{"type":"string"},"filters":{"type":"array","items":{}},"display":{"type":"object","properties":{"metricSection":{"type":"object","properties":{"position":{"type":"number"}}}}}}}},"description":"JSON schema describing the device type properties."},"id":{"type":"string","description":"Unique identifier of this record."},"type":{},"correlationId":{"description":"Client-supplied correlation id, echoed back for request tracing."},"_ts":{"type":"number"}},"description":"UI schema for rendering the device type."}}}},"example":[{"deviceTypeId":1,"deviceTypeName":"SampleDeviceType","schema":[{"modelId":"model-abc","propertyName":"engineStatus","propertyTitle":"Engine Status","propertyType":"gateway","valueType":"boolean"}],"uiSchema":{"deviceTypeId":1,"deviceTypeName":"SampleDeviceType","deviceTypeDisplayName":"Sample Device Type Display","schema":{"deviceId":{"field":"deviceId","type":"gateway","unit":"","name":"Device ID","icon":"device-icon","filters":[],"display":{"staticSection":{"position":1}}},"serial":{"field":"serial","type":"gateway","unit":"","name":"Serial Number","icon":"serial-icon","filters":[],"display":{"staticSection":{"position":2}}},"createdDate":{"field":"createdDate","type":"gateway","unit":"","name":"Created Date","icon":"calendar-icon","filters":[],"display":{"staticSection":{"position":3}}}}}}]}}},"400":{"description":"Invalid Request"},"401":{"description":"Invalid API Key provided or Invalid Access token"},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerspioError"},"example":{"functionName":"Perspio.API.Devices.DeviceDetailsApi.GetDeviceTypes","errorType":"NullReferenceException","statusCode":500,"request":"GET /api/devicetypes","tenantId":"in-93b1a4c6-1234-4c1c-9d2a-1f2e3d4c5b6a","message":"Internal Server Error: Object reference not set to an instance of an object."}}}}}}},"/updates/count":{"get":{"tags":["Telemetry"],"summary":"Get Device Updates Count","description":"Fetch update count of all devices.","operationId":"getDeviceUpdatesCount","parameters":[{"name":"from","in":"query","description":"Start time in ISO 8601 format","required":true,"schema":{"type":"string","format":"date-time","example":"2024-06-18T01:50:43.0000000+00:00"}},{"name":"to","in":"query","description":"End time in ISO 8601 format","required":true,"schema":{"type":"string","format":"date-time","example":"2024-06-19T01:50:43.0000000+00:00"}}],"responses":{"200":{"description":"Successful state modification. Returns list of records with counts.","content":{"application/json":{"schema":{"type":"array","items":{"type":"object","properties":{"id":{"type":"string","description":"Unique identifier of the record (can be TK-, G9-, MS-, DM- prefixed).","example":"TK-863251070348797"},"recordCount":{"type":"integer","description":"Count of records associated with the id.","format":"int64","example":44187}}}},"examples":{"sample":{"summary":"Example response","value":[{"id":"TK-863251070348797","recordCount":44187},{"id":"G9ZR43FXJ8K8","recordCount":29556}]}}}}},"400":{"description":"Invalid Request"},"401":{"description":"Invalid API Key provided or Invalid Access token"},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerspioError"},"example":{"functionName":"Perspio.API.Devices.DeviceDetailsApi.GetDeviceUpdatesCount","errorType":"NullReferenceException","statusCode":500,"request":"GET /api/devicesV2/metrics/counters","tenantId":"in-93b1a4c6-1234-4c1c-9d2a-1f2e3d4c5b6a","message":"Internal Server Error: Object reference not set to an instance of an object."}}}}}}},"/importdevicestask":{"post":{"tags":["Jobs"],"summary":"Create Device Import Job","description":"Submit a devices import task","operationId":"createDeviceImportJob","requestBody":{"content":{"multipart/form-data":{"schema":{"required":["file"],"properties":{"file":{"type":"string","description":"The CSV file to import.","format":"binary"}}}}}},"responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"statusUrl":{"type":"string","nullable":true}}},"example":{"statusUrl":"https://talk.perspio.dev/tasks/v3/in-task-61667e2d-5268-42fa-bd82-87cf66d7188a"}}}},"400":{"description":"Invalid Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerspioError"},"example":{"error":{"stackTrace":"string"},"errorType":"string","message":"string","method":"string","request":"string","statusCode":0}}}},"401":{"description":"Invalid API Key provided or Invalid Access token"},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerspioError"},"example":{"error":{"stackTrace":"string"},"errorType":"string","message":"string","method":"string","request":"string","statusCode":0}}}}}}},"/bulkupdatedevicetask":{"post":{"tags":["Jobs"],"summary":"Create Device Bulk Update Job","description":"Submit a bulk device update task","operationId":"createDeviceBulkUpdateJob","requestBody":{"description":"Bulk device update request payload","content":{"application/json":{"schema":{"$ref":"#/components/schemas/BulkUpdateDeviceRequest"},"example":{"scope":{"scopeType":101,"objectRefs":["AC-WUP101841-DEMO"]},"patchItems":[{"op":"replace","path":"/deviceInfo/historyEnabled","value":true},{"op":"replace","path":"/deviceInfo/runHoursOffset","value":321.45}]}}}},"responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"type":"object","properties":{"statusUrl":{"type":"string","nullable":true}}},"example":{"statusUrl":"https://talk.perspio.dev/tasks/v3/in-task-61667e2d-5268-42fa-bd82-87cf66d7188a"}}}},"400":{"description":"Invalid Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerspioError"},"example":{"error":{"stackTrace":"string"},"errorType":"string","message":"string","method":"string","request":"string","statusCode":0}}}},"401":{"description":"Invalid API Key provided or Invalid Access token"},"500":{"description":"Internal Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/PerspioError"},"example":{"error":{"stackTrace":"string"},"errorType":"string","message":"string","method":"string","request":"string","statusCode":0}}}}}}}},"components":{"schemas":{"PerspioError":{"type":"object","properties":{"functionName":{"type":"string","description":"Name of the backend function that raised the error."},"errorType":{"type":"string","description":"Exception/error type name."},"statusCode":{"type":"integer","description":"HTTP status code of the error.","format":"int32"},"request":{"type":"string","description":"Method and URL of the failing request."},"tenantId":{"type":"string","description":"Tenant the request was executed for."},"message":{"type":"string","description":"Human-readable error message."}},"description":"Standard Perspio backend error body (ErrorResultObject emitted by the error-handling middleware)."},"BulkUpdateDeviceRequest":{"required":["scope","patchItems"],"type":"object","properties":{"scope":{"$ref":"#/components/schemas/DeviceScope"},"patchItems":{"type":"array","items":{"$ref":"#/components/schemas/PropertyPatchItem"},"description":"Patch items. Only deviceInfo.* paths are accepted."}}},"DeviceScope":{"required":["scopeType","objectRefs"],"type":"object","properties":{"scopeType":{"$ref":"#/components/schemas/DeviceScopeTypes"},"objectRefs":{"type":"array","items":{"type":"string"}}}},"DeviceScopeTypes":{"enum":[101,103,105],"type":"integer","description":"Device scopes: 101 DeviceId, 103 DeviceType, 105 TenantDevices.","format":"int32","x-enumNames":["DeviceId","DeviceType","TenantDevices"]},"PropertyPatchItem":{"required":["op","path"],"type":"object","properties":{"op":{"type":"string"},"path":{"type":"string"},"value":{"type":"object"}}},"UpdateOdometer-RequestObject":{"type":"object","properties":{"value":{"type":"integer","description":"Page of result records."},"path":{"type":"string"},"op":{"type":"string"}}},"UpdateHourMeter-RequestObject":{"type":"object","properties":{"value":{"type":"integer","description":"Page of result records."},"path":{"type":"string"},"op":{"type":"string"}}},"UpdateDevice-RequestObject":{"type":"array","items":{"required":["value","path","op"],"type":"object","properties":{"value":{"type":"string","description":"Page of result records."},"path":{"type":"string"},"op":{"type":"string"}}}},"Sucess-DevicesCatalog":{"type":"array","items":{"required":["tenantId","mirroredTenantIds","deviceInfo","sourceDeviceId","createdBy","createdDate","updatedBy","ownedBy","updatedDate","id","type","correlationId","_ts"],"type":"object","properties":{"tenantId":{"type":"string","description":"Identifier of the owning tenant."},"mirroredTenantIds":{"type":"array"},"deviceInfo":{"type":"object","properties":{"deviceTypeId":{"type":"integer","description":"Identifier of the device type (its schema)."},"perspioDeviceId":{"type":"integer"},"perspioPipelineId":{"type":"string"},"serial":{"type":"string","description":"Device serial number."},"imei":{"type":"string"},"uuid":{"type":"string"},"euid":{"type":"string"},"mac":{"type":"string"},"iccid":{"type":"string"},"vendorInternalId":{"type":"string"},"vendorTenantName":{"type":"string"},"simInfo":{"type":"object","properties":{"vendor":{},"imsi":{},"msisdn":{},"status":{},"ratePlan":{},"communicationPlan":{},"customer":{},"dateActivated":{},"dateAdded":{},"dateUpdated":{},"dateShipped":{},"accountId":{},"fixedIPAddress":{},"notes":{},"euiccid":{},"deviceID":{"description":"Unique device identifier."},"modemID":{},"dataUsage":{},"sessionCount":{},"limitReached":{},"limitOverride":{}}},"comment":{},"isActive":{"type":"boolean"},"managedBy":{"type":"string"}},"description":"Descriptive device metadata (name and related details)."},"deviceStatus":{"type":"integer","description":"Lifecycle status of the device."},"sourceDeviceId":{"description":"Native device id from the originating source system."},"createdBy":{"description":"User or system that created the record."},"createdDate":{"type":"string","description":"UTC timestamp when the record was created."},"updatedBy":{"description":"User or system that last modified the record."},"ownedBy":{},"updatedDate":{"type":"string","description":"UTC timestamp when the record was last modified."},"id":{"type":"string","description":"Unique identifier of this record."},"type":{"type":"string"},"correlationId":{"description":"Client-supplied correlation id, echoed back for request tracing."},"_ts":{"type":"integer"}}}},"DeviceMetrics":{"type":"object","properties":{"timeZone":{"type":"array","items":{"type":"object","properties":{"ts":{"type":"string","description":"Store timestamp (Unix epoch seconds) of the last write.","format":"date-time","example":"2025-01-15T04:39:41.0000000+00:00"},"val":{"type":"string","example":"Central Standard Time"},"pipelineId":{"type":"string","description":"Id of the ingestion pipeline feeding this device.","example":"ic-000006"}}}},"speed":{"type":"array","items":{"type":"object","properties":{"ts":{"type":"string","description":"Store timestamp (Unix epoch seconds) of the last write.","format":"date-time","example":"2025-01-16T05:10:49.0000000+00:00"},"val":{"type":"string","example":"0.0"},"pipelineId":{"type":"string","description":"Id of the ingestion pipeline feeding this device.","example":"ic-000006"}}}},"preferredRunHours":{"type":"array","items":{"type":"object","properties":{"ts":{"type":"string","description":"Store timestamp (Unix epoch seconds) of the last write.","format":"date-time","example":"2025-01-16T05:40:04.0000000+00:00"},"val":{"type":"string","example":"0.86"},"pipelineId":{"type":"string","description":"Id of the ingestion pipeline feeding this device.","example":"PerspioMeterTrigger"}}}},"preferredOdometer":{"type":"array","items":{"type":"object","properties":{"ts":{"type":"string","description":"Store timestamp (Unix epoch seconds) of the last write.","format":"date-time","example":"2025-01-16T02:05:16.0000000+00:00"},"val":{"type":"string","example":"0"},"pipelineId":{"type":"string","description":"Id of the ingestion pipeline feeding this device.","example":"PerspioMeterTrigger"}}}},"perspioRunHours":{"type":"array","items":{"type":"object","properties":{"ts":{"type":"string","description":"Store timestamp (Unix epoch seconds) of the last write.","format":"date-time","example":"2025-01-16T05:40:04.0000000+00:00"},"val":{"type":"string","example":"0.86"},"pipelineId":{"type":"string","description":"Id of the ingestion pipeline feeding this device.","example":"PerspioMeterTrigger"}}}},"perspioOdometer":{"type":"array","items":{"type":"object","properties":{"ts":{"type":"string","description":"Store timestamp (Unix epoch seconds) of the last write.","format":"date-time","example":"2025-01-16T02:05:16.0000000+00:00"},"val":{"type":"string","example":"0"},"pipelineId":{"type":"string","description":"Id of the ingestion pipeline feeding this device.","example":"PerspioMeterTrigger"}}}},"longitude":{"type":"array","items":{"type":"object","properties":{"ts":{"type":"string","description":"Store timestamp (Unix epoch seconds) of the last write.","format":"date-time","example":"2025-01-16T05:10:49.0000000+00:00"},"val":{"type":"string","example":"-94.69159"},"pipelineId":{"type":"string","description":"Id of the ingestion pipeline feeding this device.","example":"ic-000006"}}},"description":"Longitude of the last known position."},"latitude":{"type":"array","items":{"type":"object","properties":{"ts":{"type":"string","description":"Store timestamp (Unix epoch seconds) of the last write.","format":"date-time","example":"2025-01-16T05:10:49.0000000+00:00"},"val":{"type":"string","example":"38.9479"},"pipelineId":{"type":"string","description":"Id of the ingestion pipeline feeding this device.","example":"ic-000006"}}},"description":"Latitude of the last known position."},"internalBatteryVoltage":{"type":"array","items":{"type":"object","properties":{"ts":{"type":"string","description":"Store timestamp (Unix epoch seconds) of the last write.","format":"date-time","example":"2025-01-15T11:05:08.0000000+00:00"},"val":{"type":"string","example":"5.027"},"pipelineId":{"type":"string","description":"Id of the ingestion pipeline feeding this device.","example":"ic-000006"}}}},"coordinates":{"type":"array","items":{"type":"object","properties":{"ts":{"type":"string","description":"Store timestamp (Unix epoch seconds) of the last write.","format":"date-time","example":"2025-01-16T05:10:49.0000000+00:00"},"val":{"type":"string","example":"38.9479,-94.69159"},"pipelineId":{"type":"string","description":"Id of the ingestion pipeline feeding this device.","example":"ic-000006"}}},"description":"Coordinate array defining the position ([lon, lat] order)."},"altitude":{"type":"array","items":{"type":"object","properties":{"ts":{"type":"string","description":"Store timestamp (Unix epoch seconds) of the last write.","format":"date-time","example":"2025-01-16T05:10:49.0000000+00:00"},"val":{"type":"string","example":"423.0"},"pipelineId":{"type":"string","description":"Id of the ingestion pipeline feeding this device.","example":"ic-000006"}}}},"active":{"type":"array","items":{"type":"object","properties":{"ts":{"type":"string","description":"Store timestamp (Unix epoch seconds) of the last write.","format":"date-time","example":"2025-01-16T05:17:34.0000000+00:00"},"val":{"type":"string","example":"False"},"pipelineId":{"type":"string","description":"Id of the ingestion pipeline feeding this device.","example":"ic-000006"}}},"description":"Whether the device is currently active/enabled."}}}},"securitySchemes":{"oauth2":{"type":"oauth2","description":"Client credentials from your Perspio API application. See Get Access Token.","flows":{"clientCredentials":{"tokenUrl":"/auth/v3/token","scopes":{}}}},"subscriptionKey":{"type":"apiKey","name":"Ocp-Apim-Subscription-Key","in":"header","description":"Your tenant's subscription key, from your API application."},"tenantId":{"type":"apiKey","name":"tid","in":"header","description":"Your tenant ID (tid), from your API application."}}},"security":[{"oauth2":[],"subscriptionKey":[],"tenantId":[]}],"tags":[{"name":"Devices","description":"Device records, snapshots and updates."},{"name":"Telemetry","description":"Device telemetry metrics and update counters."},{"name":"Metadata","description":"Device metadata and info lookups."}],"x-readme":{"oauth-options":{"useInsecureClientAuthentication":true}}}