{
  "id": "backup-status",
  "title": "BACKUP STATUS",
  "url": "https://redis.io/docs/latest/commands/backup-status/",
  "summary": "Report the current backup state.",
  "tags": [
    "docs",
    "develop",
    "stack",
    "oss",
    "rs",
    "rc",
    "oss",
    "kubernetes",
    "clients"
  ],
  "last_updated": "2026-07-30T08:54:30-07:00",
  "page_type": "content",
  "content_hash": "9ccc49bc066d1b181fab5f810460cb412670740cf538d03f20264053ab2f1b9d",
  "sections": [
    {
      "id": "overview",
      "title": "Overview",
      "role": "overview",
      "text": "Reports the current backup state."
    },
    {
      "id": "examples",
      "title": "Examples",
      "role": "example",
      "text": "[code example]"
    },
    {
      "id": "details",
      "title": "Details",
      "role": "content",
      "text": "`BACKUP STATUS` reports the current state of the backup state machine along with timing and error information. The reply contains the following fields:\n\n| Field | Description |\n|:------|:------------|\n| `state` | The current backup state (see below). |\n| `error` | The error message if the backup failed; an empty string otherwise. |\n| `start_time` | The Unix time, in seconds, when the current backup started; `0` if no backup has started. |\n| `end_time` | The Unix time, in seconds, when the current backup was sealed; `0` if it has not been sealed. |\n\nThe `state` field is one of the following:\n\n| State | Description |\n|:------|:------------|\n| `idle` | No backup is in progress. |\n| `pending` | A backup was requested but is waiting for an append-only file rewrite (AOFRW) to become available. |\n| `snapshotting` | Redis is producing the BASE snapshot. |\n| `incrementing` | The BASE snapshot is complete and pinned; Redis is accumulating incremental writes and waiting to be sealed. |\n| `sealed` | The backup is frozen; the file set is complete and immutable, awaiting data-plane consumption and cleanup. |\n| `failed` | The backup failed or was aborted. A new backup can be started. |\n\nFor lightweight monitoring, `INFO persistence` also exposes a `backup_in_progress` boolean. Full backup state, error, and timestamps are available only through `BACKUP STATUS`.\n\nFor the full workflow, see [Redis persistence](https://redis.io/docs/latest/operate/oss_and_stack/management/persistence#online-backups-with-the-backup-command-family)."
    },
    {
      "id": "redis-software-and-redis-cloud-compatibility",
      "title": "Redis Software and Redis Cloud compatibility",
      "role": "content",
      "text": "| Redis<br />Software | Redis<br />Cloud | <span style=\"min-width: 9em; display: table-cell\">Notes</span> |\n|:----------------------|:-----------------|:------|\n| <span title=\"Not supported\">&#x274c; Standard</span><br /><span title=\"Not supported\"><nobr>&#x274c; Active-Active</nobr></span> | <span title=\"Not supported\">&#x274c; Standard</span><br /><span title=\"Not supported\"><nobr>&#x274c; Active-Active</nobr></span> |  |"
    },
    {
      "id": "return-information",
      "title": "Return information",
      "role": "returns",
      "text": "**RESP2:**\n\n[Array reply](../../develop/reference/protocol-spec#arrays): a flat array of field-value pairs describing the current backup state.\n\n**RESP3:**\n\n[Map reply](../../develop/reference/protocol-spec#maps): a map of fields to values describing the current backup state."
    },
    {
      "id": "see-also",
      "title": "See also",
      "role": "related",
      "text": "[`BACKUP START`](https://redis.io/docs/latest/commands/backup-start/) | [`BACKUP SEAL`](https://redis.io/docs/latest/commands/backup-seal/) | [`BACKUP LIST`](https://redis.io/docs/latest/commands/backup-list/) | [`BACKUP ABORT`](https://redis.io/docs/latest/commands/backup-abort/) | [`BACKUP CLEANUP`](https://redis.io/docs/latest/commands/backup-cleanup/)"
    },
    {
      "id": "related-topics",
      "title": "Related topics",
      "role": "related",
      "text": "- [Redis persistence](https://redis.io/docs/latest/operate/oss_and_stack/management/persistence)"
    }
  ],
  "examples": [
    {
      "id": "examples-ex0",
      "language": "plaintext",
      "code": "127.0.0.1:6379> BACKUP STATUS\n1) \"state\"\n2) \"incrementing\"\n3) \"error\"\n4) \"\"\n5) \"start_time\"\n6) \"1717921800\"\n7) \"end_time\"\n8) \"0\"",
      "section_id": "examples"
    }
  ]
}