---
title: "List pending backup shares into and out of this space"
method: GET
path: "/spaces/{spaceId}/backup-shares"
tags: ["Backups"]
---

# List pending backup shares into and out of this space

`GET /spaces/{spaceId}/backup-shares`

## Request

- Base URL: `https://krova.cloud/api/v1`
- URL: `https://krova.cloud/api/v1/spaces/{spaceId}/backup-shares`
- Auth: API key in header `X-API-KEY`

## Path parameters

- `spaceId` string, required

## Response `200`

`incoming` asks this space to accept a copy; `outgoing` was offered by this space

- object
  - `incoming` BackupShare[], required
    - `id` string, required
    - `status` 'pending' | 'accepted' | 'declined' | 'canceled' | 'expired', required
    - `backupId` string, required: The SOURCE backup being shared.
    - `backupName` string, required
    - `sourceSpaceId` string, required
    - `destinationSpaceId` string, required
    - `counterpartySpaceName` string, required: The other space in this share: the destination on an outgoing share, the source on an incoming one.
    - `copyBackupId` string, nullable, required: The destination space's own copy, once the share is accepted.
    - `expiresAt` string, date-time, required
    - `createdAt` string, date-time, required
  - `outgoing` BackupShare[], required
    - `id` string, required
    - `status` 'pending' | 'accepted' | 'declined' | 'canceled' | 'expired', required
    - `backupId` string, required: The SOURCE backup being shared.
    - `backupName` string, required
    - `sourceSpaceId` string, required
    - `destinationSpaceId` string, required
    - `counterpartySpaceName` string, required: The other space in this share: the destination on an outgoing share, the source on an incoming one.
    - `copyBackupId` string, nullable, required: The destination space's own copy, once the share is accepted.
    - `expiresAt` string, date-time, required
    - `createdAt` string, date-time, required

## Other responses

- `403`: Authenticated but lacks the required permission

---

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