Read S.M.A.R.T. data

get/api/v1/metrics/smart

Response

Example response

{
  "data": {
    "available_spare": "100%",
    "available_spare_threshold": "10%",
    "controller_busy_time": "0",
    "critical_warning": "0",
    "data_units_read": "1234567",
    "data_units_written": "7654321",
    "host_read_commands": "100000",
    "host_write_commands": "50000",
    "percentage_used": "5",
    "power_cycles": "100",
    "power_on_hours": "1000",
    "smart_overall_health_self_assessment_test_result": "PASSED",
    "temperature": "35C",
    "unsafe_shutdowns": "0"
  },
  "errors": [
    {
      "metric": [
        "cpu.temperature"
      ]
    }
  ]
}

Changes

Changed in 5 of the 8 revisions of this API.5435

Dec 6, 2025577d4aa2949c22See the full diff
- ●
  removed the optional property errors/items/error from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property errors/items/error from the response with the 207 status
  response-optional-property-removed
- ○
  added the optional property errors/items/err to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property errors/items/err to the response with the 207 status
  response-optional-property-added
Jul 17, 2025a5791047c7e4430See the full diff
- ▲
  the data response's property type/format changed from array/ to object/ for status 200
  response-property-type-changed
- ▲
  the data response's property type/format changed from array/ to object/ for status 207
  response-property-type-changed
- ▲
  the errors/items/metric response's property type/format changed from string/ to array/ for status 200
  response-property-type-changed
- ▲
  the errors/items/metric response's property type/format changed from string/ to array/ for status 207
  response-property-type-changed
- ○
  the endpoint scheme security type AND scheme AND bearerFormat was added to the API
  api-security-added
- ○
  the endpoint scheme security bearerAuth was removed from the API
  api-security-removed
- ○
  added the optional property data/available_spare to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/available_spare to the response with the 207 status
  response-optional-property-added
- ○
  added the optional property data/available_spare_threshold to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/available_spare_threshold to the response with the 207 status
  response-optional-property-added
- ○
  added the optional property data/controller_busy_time to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/controller_busy_time to the response with the 207 status
  response-optional-property-added
- ○
  added the optional property data/critical_warning to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/critical_warning to the response with the 207 status
  response-optional-property-added
- ○
  added the optional property data/data_units_read to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/data_units_read to the response with the 207 status
  response-optional-property-added
- ○
  added the optional property data/data_units_written to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/data_units_written to the response with the 207 status
  response-optional-property-added
- ○
  added the optional property data/host_read_commands to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/host_read_commands to the response with the 207 status
  response-optional-property-added
- ○
  added the optional property data/host_write_commands to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/host_write_commands to the response with the 207 status
  response-optional-property-added
- ○
  added the optional property data/percentage_used to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/percentage_used to the response with the 207 status
  response-optional-property-added
- ○
  added the optional property data/power_cycles to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/power_cycles to the response with the 207 status
  response-optional-property-added
- ○
  added the optional property data/power_on_hours to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/power_on_hours to the response with the 207 status
  response-optional-property-added
- ○
  added the optional property data/smart_overall_health_self_assessment_test_result to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/smart_overall_health_self_assessment_test_result to the response with the 207 status
  response-optional-property-added
- ○
  added the optional property data/temperature to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/temperature to the response with the 207 status
  response-optional-property-added
- ○
  added the optional property data/unsafe_shutdowns to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/unsafe_shutdowns to the response with the 207 status
  response-optional-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 4, 202535f78511ceb022See the full diff
- ●
  removed the optional property data/items/smart_overall-health_self-assessment_test_result from the response with the 200 status
  response-optional-property-removed
- ●
  removed the optional property data/items/smart_overall-health_self-assessment_test_result from the response with the 207 status
  response-optional-property-removed
- ○
  added the optional property data/items/smart_overall_health_self_assessment_test_result to the response with the 200 status
  response-optional-property-added
- ○
  added the optional property data/items/smart_overall_health_self_assessment_test_result to the response with the 207 status
  response-optional-property-added
Jun 4, 202569b4529f7c411See the full diff
- ○
  endpoint added
  endpoint-added
Dec 16, 20240e2250f78cf01See the full diff
- ▲
  api path removed without deprecation
  api-path-removed-without-deprecation
This revision also has 10 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history