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

# Get device configuration backup

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

Retrieve a single stored configuration backup of the given node including running and startup configuration content. Text configurations are returned as UTF-8 strings; binary configurations are base64-encoded. Requires the dedicated read-device-configuration access right on the node; denied requests are recorded in the audit log.

## Path parameters

- `object-id` integer, required
- `backup-id` integer, required

## Response `200`

Backup with configuration content

- DeviceConfigBackup
  - `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
  - `runningConfig` string, nullable — Running configuration content (UTF-8 text, or base64 when isBinary is true)
  - `startupConfig` string, nullable — Startup configuration content (UTF-8 text, or base64 when isBinary is true); null if not stored

## Other responses

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

## 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/:backup-id/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/a203de7e5d7d?raw)