---
title: "List device configuration backups"
method: GET
path: "/v1/objects/{object-id}/device-config-backups"
tags: ["Objects"]
---

# List device configuration backups

`GET /v1/objects/{object-id}/device-config-backups`

Retrieve metadata of all stored configuration backups of the given node (timestamps, sizes and SHA-256 hashes, without configuration content). Requires a device backup provider module to be loaded on the server.

## Path parameters

- `object-id` integer, required

## Response `200`

List of backups, newest first as returned by backup provider

- DeviceConfigBackupSummary[]
  - `id` integer — Backup ID
  - `timestamp` string, date-time — Time the backup was taken
  - `lastCheckTime` string, date-time, nullable — Last time the backup provider verified the device configuration against this backup
  - `isBinary` boolean — True if configuration content is binary rather than text
  - `runningConfigSize` integer — Size of running configuration in bytes
  - `runningConfigHash` string — SHA-256 hash of running configuration as hexadecimal string
  - `startupConfigSize` integer — Size of startup configuration in bytes (0 if not stored)
  - `startupConfigHash` string — SHA-256 hash of startup configuration as hexadecimal string

## Other responses

- `400` — Invalid object ID or object is not a node
- `401` — Unauthorized
- `403` — User does not have read access to given object
- `404` — Object with given ID does not exist
- `500` — Backup provider is unavailable or failed to return backup list
- `501` — Backup provider does not implement backup listing

## Changes

- **2026-09-15** `c87f37318fa9` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/netxms/apis/netxms-api/changes/v1/objects/:object-id/device-config-backups/get.md)

---

[API](https://skmtc.dev/netxms/apis/netxms-api.md) · [All operations](https://skmtc.dev/netxms/apis/netxms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/netxms/apis/netxms-api/revisions/a81265c49fa9?raw)