Skip to main content
POST
/
v1
/
backup
/
recover
Recover encrypted backup data
curl --request POST \
  --url https://orchestrator.control.coincover.com/v1/backup/recover \
  --header 'Content-Type: application/json' \
  --header 'X-API-Key: <api-key>' \
  --data '
{
  "user_identifier": "john.doe@example.com",
  "verification_id": "inq_abc123xyz",
  "gpg_public_key": "-----BEGIN PGP PUBLIC KEY BLOCK-----\n...\n-----END PGP PUBLIC KEY BLOCK-----"
}
'
{
  "backup": [
    {
      "backup_id": "550e8400-e29b-41d4-a716-446655440000",
      "backup_item_key": "seed_phrase",
      "recovery_id": "660e8400-e29b-41d4-a716-446655440001",
      "recovery_package": {
        "algorithm": "gpg",
        "data": "LS0tLS1CRUdJTiBQR1AgTUVTU0FHRS0tLS0tCkNpY2VsbGEgZGljdGEgc2VkIGVsZWlmZW5kLi4uCg=="
      },
      "original_filename": "backup.json",
      "content_type": "application/json",
      "original_size": "1024"
    }
  ]
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication and authorization

Body

application/json
​
user_identifier
string
required

User identifier (REQUIRED)

Example:

"john.doe@example.com"

​
verification_id
string
required

Verification ID from a successful verification. (REQUIRED) Must be approved/successful.

Example:

"inq_abc123xyz"

​
gpg_public_key
string
required

GPG public key in PGP public key block format for encrypting the recovered data. (REQUIRED)

Pattern: ^-----BEGIN PGP PUBLIC KEY BLOCK-----[\s\S]*?-----END PGP PUBLIC KEY BLOCK-----$
Example:

"-----BEGIN PGP PUBLIC KEY BLOCK-----\n...\n-----END PGP PUBLIC KEY BLOCK-----"

Response

200 - application/json

Backup recovered successfully

​
backup
object[]
required

Array of recovered backup items. Each item contains recovery information or error details.