---
title: "List background operations"
method: GET
path: "/v2/databases/{databaseID}/operations-status"
tags: ["Metrics & Events"]
---

# List background operations

`GET /v2/databases/{databaseID}/operations-status`

## Request

- Base URL: `https://api.liara.ir`
- URL: `https://api.liara.ir/v2/databases/{databaseID}/operations-status`
- Auth: HTTP bearer

Lists the database's background operations from the last month, such as backups, password resets, disk resizes, restores and backup file imports, newest first. Team permission: `view`, `operate` or `manage`.

## Path parameters

- `databaseID` string, required: 24-character hexadecimal ID.

## Query parameters

- `teamID` string: 24-character hexadecimal ID.
- `type` 'DatabaseDump' | 'DatabaseResetPassword' | 'VolumeResize' | 'DatabaseRestore' | 'MssqlPutBakFile' | 'ClickhousePutBakFile': `DatabaseDump`: backup. `DatabaseResetPassword`: password reset. `VolumeResize`: disk resize. `DatabaseRestore`: restore. `MssqlPutBakFile` / `ClickhousePutBakFile`: backup file import.
- `status` 'queued' | 'in_progress' | 'succeeded' | 'failed'
- `interval` 'manual' | 'hourly' | 'daily' | 'weekly' | 'monthly'
- `page` integer
- `count` integer

## Response `200`

Operations.

- object
  - `totalOperations` integer
  - `operations` object[]
    - `_id` string
    - `name` 'DatabaseDump' | 'DatabaseResetPassword' | 'VolumeResize' | 'DatabaseRestore' | 'MssqlPutBakFile' | 'ClickhousePutBakFile': `DatabaseDump`: backup. `DatabaseResetPassword`: password reset. `VolumeResize`: disk resize. `DatabaseRestore`: restore. `MssqlPutBakFile` / `ClickhousePutBakFile`: backup file import.
    - `createdAt` string, date-time: When the operation was queued.
    - `lockedAt` string, date-time: When it started. Missing while it's queued.
    - `succeededAt` string, date-time
    - `failedAt` string, date-time
    - `data` object
      - `interval` string: For backups, the backup interval.

## Other responses

- `400`: The body or a parameter is invalid (`message` says which), or `teamID` isn't a valid ID.
- `401`: The API token is missing, invalid or expired.
- `403`: With `teamID`: you aren't a member of the team (`team_not_found`), or you don't have the required permission on this database (`no_permission`).
- `404`: The database doesn't exist.

## Changes

> 21 revisions in range; 1 not diffed.

- **2026-11-02** `f6f78c6f05c6`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/liara-cloud/apis/dbaas/changes/v2/databases/:databaseID/operations-status/get.md)

---

[API](https://skmtc.dev/liara-cloud/apis/dbaas.md) - [All operations](https://skmtc.dev/liara-cloud/apis/dbaas/llms.txt) - [OpenAPI document](https://skmtc.dev/liara-cloud/apis/dbaas/revisions/f6f78c6f05c6?raw)