---
title: "Organization location backup usage"
method: GET
path: "/v2/organization/{id}/locations/{locationId}/backup/usage"
tags: ["organization"]
---

# Organization location backup usage

`GET /v2/organization/{id}/locations/{locationId}/backup/usage`

## Request

- Base URL: `https://app.ninjarmm.com` (the document declares no server; this is the origin it was published from)
- URL: `https://app.ninjarmm.com/v2/organization/{id}/locations/{locationId}/backup/usage`
- Auth: one of:
  - HTTP bearer
  - API key in cookie `sessionKey`
- TypeScript: <https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/docs/v2/organization/:id/locations/:locationId/backup/usage/get.ts> (a function with typed inputs; its response is checked against the schema)

Returns a location backup usage

## Path parameters

- `id` integer, required
- `locationId` integer, required

## Response `200`

Returns a location backup usage

- object
  - `locationId` integer: Device location id
  - `locationName` string: Device location name
  - `locationDescription` string: Device location description
  - `revisionsCurrentSize` integer
  - `revisionsPreviousSize` integer
  - `revisionsDeletedSize` integer
  - `localFileFolderSize` integer
  - `localImageSize` integer
  - `localImageV2Size` integer
  - `cloudFileFolderSize` integer
  - `cloudImageSize` integer
  - `cloudImageV2Size` integer
  - `cloudNetworkShareSize` integer
  - `lastSuccessfulBackupJob` number, double
  - `lastFailedBackupJob` number, double
  - `organizationId` integer
  - `organizationName` string
  - `revisionsTotalSize` integer: Revisions total size
  - `cloudTotalSize` integer: Revisions cloud total size
  - `localTotalSize` integer: Revisions local total size

## Changes

- **2025-12-12** `7c00bdd989ee`: 3 info
  - added the optional property `cloudImageV2Size` to the response with the `200` status
  - added the optional property `cloudNetworkShareSize` to the response with the `200` status
  - added the optional property `localImageV2Size` to the response with the `200` status
- **2025-01-07** `c17cc5d9bb23`: 2 info
  - added the optional property `lastFailedBackupJob` to the response with the `200` status
  - added the optional property `lastSuccessfulBackupJob` to the response with the `200` status
- **2024-03-04** `8811c70de9a8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/changes/v2/organization/:id/locations/:locationId/backup/usage/get.md)

---

[API](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0.md) - [All operations](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/llms.txt) - [OpenAPI document](https://skmtc.dev/ninjarmm/apis/ninjaone-public-api-2-0/revisions/5ce571d1bb71?raw)