Get a PostgreSQL backup

Reviewed on September 30, 2026

You can get the details of a backup of a PostgreSQL cluster within your space.

Permissions

info

This action requires the following IAM (Identity and Access Management) permissions:

• postgresql.cluster.get

API

API

The request GET /postgresql/spaces/{spaceId}/clusters/{clusterId}/backups/{backupId} retrieves the details of a PostgreSQL cluster backup.

Parameters

Parameter	Type	Required	Description
spaceId	string	Yes	The Numspot space ID.
clusterId	string	Yes	The PostgreSQL cluster ID.
backupId	string	Yes	The backup ID.

Example response

{
  "id": "123e4567-e89b-42d3-a456-426614174000",
  "clusterId": "550e8400-e29b-41d4-a716-446655440002",
  "clusterName": "my-cluster-postgresql",
  "name": "daily-backup",
  "type": "ON_DEMAND",
  "target": "PREFER_STANDBY",
  "status": {
    "state": "SUCCEEDED",
    "message": "backup completed"
  },
  "startedAt": "2026-09-01T02:00:00Z",
  "completedAt": "2026-09-01T02:15:00Z"
}

View the full specification