Recovers previously stored backup data. Requires successful identity verification (verification_id must be approved/successful). Requires a GPG public key for encrypting the recovered data. Returns an array of backup recovery results, each containing recovery information or error details. This endpoint calls the hot-keys orchestrator recover-backup endpoint for each backup associated with the user.
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-----", "rsa_public_key": "-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----"}'
RSA public key (PEM SPKI, or hex-encoded SPKI DER). The recovered data is encrypted to it: rsa-direct for small payloads, hybrid-rsa-aes256-gcm otherwise. Use a one-time key generated on the user's device so only that device can read the result. Provide exactly one of gpg_public_key or rsa_public_key.
Example:
"-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----"
Array of recovered backup items. Each item contains recovery information or error details.
Show child attributes
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Coincover Developer Docs","colors":{"primary":"#3939EF","light":"#B59BFD","dark":"#B59BFD"},"logo":{"light":"https://mintcdn.com/coincover/YulmKC25AtRiJdum/images/CC-Logo-Black.svg?fit=max\u0026auto=format\u0026n=YulmKC25AtRiJdum\u0026q=85\u0026s=d81d260390cff9797e850679aeec6841","dark":"https://mintcdn.com/coincover/YulmKC25AtRiJdum/images/CC-Logo-White.svg?fit=max\u0026auto=format\u0026n=YulmKC25AtRiJdum\u0026q=85\u0026s=e4baa96369293d28a43a8fee6c4db806","href":"https://www.coincover.com/"},"favicon":"https://mintcdn.com/coincover/YulmKC25AtRiJdum/images/Favicon32px.svg?fit=max\u0026auto=format\u0026n=YulmKC25AtRiJdum\u0026q=85\u0026s=a1f83bee4378390aeb0dd8059e55456b","appearance":{"strict":false},"background":{"color":{"light":"#FFFFFF","dark":"#0E171B"}},"navbar":{"links":[],"primary":{"type":"button","label":"Talk to us","href":"https://www.coincover.com/contact"}},"footer":{"socials":{"linkedin":"https://www.linkedin.com/company/coincoverglobal","x":"https://x.com/Coincoverglobal","website":"https://www.coincover.com"}},"fonts":{"family":"Inter","weight":400},"errors":{"404":{"redirect":true}},"contextual":{"options":["copy","view","claude","cursor"],"display":"header"},"metadata":{"timestamp":false},"styling":{"latex":false},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"coincover","hasAudioNarration":false,"actualSubdomain":"coincover","customDomains":["developer.coincover.com"],"gitSource":{"type":"github","owner":"coincover","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":false,"mountPath":"","label":""},"entitlements":{},"buildId":"6aeda83b61234cac2656d83a","clientVersion":"0.0.4088","searchFilterCounts":[{"language":"default","tag":"API Reference","count":30},{"language":"default","tag":"Products","count":13},{"language":"default","tag":"Guides","count":10},{"language":"default","tag":"Using CoinCover Control","count":9},{"language":"default","tag":"Partners","count":8},{"language":"default","tag":"Backups","count":7},{"language":"default","tag":"Recover for Institutions","count":6},{"language":"default","tag":"Retail API","count":6},{"language":"default","tag":"Keys","count":5},{"language":"default","tag":"Institutional API","count":5}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"comment-mode","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[{"filePath":"style.css","content":"@keyframes cc-marquee{from{transform:translateX(0)}to{transform:translateX(-50%)}}.cc-marquee{animation:cc-marquee var(--cc-duration, 10s) linear infinite}.cc-marquee-fade{pointer-events:none;position:absolute;top:0;bottom:0;z-index:10;width:5rem}.cc-marquee-fade-left{left:0;background:linear-gradient(to right, #ffffff, transparent)}.cc-marquee-fade-right{right:0;background:linear-gradient(to left, #ffffff, transparent)}html.dark .cc-marquee-fade-left{background:linear-gradient(to right, #0e171b, transparent)}html.dark .cc-marquee-fade-right{background:linear-gradient(to left, #0e171b, transparent)}html{overflow-x:hidden}.cc-hero{max-width:90rem}.cc-hero-bg{pointer-events:none;position:absolute;top:-12rem;right:-12rem;z-index:0;width:44rem}@media (max-width: 1023px){.cc-hero-bg{display:none}}.cc-hero-bg img{display:block;width:100%;height:auto;opacity:0.4;mix-blend-mode:screen}html.dark .cc-hero-bg img{opacity:0.55}.cc-hero-content{position:relative;z-index:1}.cc-cta{background-color:transparent}html.dark .cc-partner-logo{filter:invert(1) hue-rotate(180deg)}"}],"page":{"pagePath":"api-reference/backups/recover-encrypted-backup-data","slug":"/api-reference/backups/recover-encrypted-backup-data","pageMetadata":{"title":"Recover encrypted backup data","description":"Recovers previously stored backup data. Requires successful identity verification (verification_id must be approved/successful). Requires a GPG public key for encrypting the recovered data. Returns an array of backup recovery results, each containing recovery information or error details. This endpoint calls the hot-keys orchestrator recover-backup endpoint for each backup associated with the user.","deprecated":null,"version":null,"openapi":"/specs/retail.openapi.json post /v1/backup/recover","href":"/api-reference/backups/recover-encrypted-backup-data","autogeneratedByOpenApi":true},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Recovers previously stored backup data. Requires successful identity verification (verification_id must be approved/successful). Requires a GPG public key for encrypting the recovered data. Returns an array of backup recovery results, each containing recovery information or error details. This endpoint calls the hot-keys orchestrator recover-backup endpoint for each backup associated with the user.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Recover encrypted backup data","description":"Recovers previously stored backup data. Requires successful identity verification (verification_id must be approved/successful). Requires a GPG public key for encrypting the recovered data. Returns an array of backup recovery results, each containing recovery information or error details. This endpoint calls the hot-keys orchestrator recover-backup endpoint for each backup associated with the user.","deprecated":null,"version":null,"openapi":"/specs/retail.openapi.json post /v1/backup/recover","href":"/api-reference/backups/recover-encrypted-backup-data","autogeneratedByOpenApi":true}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"summary":"Recover encrypted backup data","description":"Recovers previously stored backup data. Requires successful identity verification (verification_id must be approved/successful). Requires a GPG public key for encrypting the recovered data. Returns an array of backup recovery results, each containing recovery information or error details. This endpoint calls the hot-keys orchestrator recover-backup endpoint for each backup associated with the user.","operationId":"recoverBackup","tags":["Backups"],"requestBody":"f031b142-f740-4f90-b8fe-4feaaf0ad6ad","responses":{"200":"14a57549-f665-47cb-9b47-b343dc6033d8"},"method":"post","type":"path","servers":["09b732ad-7b39-42ca-8cd8-0ec400b4d2d6","38b2fea1-78de-4e58-b560-28891f607a48"],"security":["743ed315-8330-474c-b797-bb1ed4412e97","aaf9ae15-3c6f-4cd7-8e13-3ab2cb404657"],"path":"/v1/backup/recover","baseUrlOptions":["https://orchestrator.control.coincover.com","https://orchestrator.uat-control.coincover.com"],"title":"Recover encrypted backup data","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated"},"dependencies":{"parameters":{},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"user_identifier":{"type":"string","description":"User identifier (REQUIRED)","example":"john.doe@example.com","isRequired":true,"uniqueKey":"user_identifier","typeLabel":"string"},"verification_id":{"type":"string","description":"Verification ID from a successful verification. (REQUIRED) Must be approved/successful.","example":"inq_abc123xyz","isRequired":true,"uniqueKey":"verification_id","typeLabel":"string"},"gpg_public_key":{"type":"string","description":"GPG public key in PGP public key block format. The recovered data is encrypted to it. Provide exactly one of gpg_public_key or rsa_public_key.","example":"-----BEGIN PGP PUBLIC KEY BLOCK-----\n...\n-----END PGP PUBLIC KEY BLOCK-----","pattern":"^-----BEGIN PGP PUBLIC KEY BLOCK-----[\\s\\S]*?-----END PGP PUBLIC KEY BLOCK-----$","uniqueKey":"gpg_public_key","typeLabel":"string"},"rsa_public_key":{"type":"string","description":"RSA public key (PEM SPKI, or hex-encoded SPKI DER). The recovered data is encrypted to it: rsa-direct for small payloads, hybrid-rsa-aes256-gcm otherwise. Use a one-time key generated on the user's device so only that device can read the result. Provide exactly one of gpg_public_key or rsa_public_key.","example":"-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----","uniqueKey":"rsa_public_key","typeLabel":"string"}},"required":["user_identifier","verification_id"],"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"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-----","rsa_public_key":"-----BEGIN PUBLIC KEY-----\n...\n-----END PUBLIC KEY-----"}}},"exampleType":"generated"}},"exampleType":"generated"},"responses":{"14a57549-f665-47cb-9b47-b343dc6033d8":{"description":"Backup recovered successfully","content":{"application/json":{"schema":{"type":"object","properties":{"backup":{"type":"array","description":"Array of recovered backup items. Each item contains recovery information or error details.","items":{"type":"object","properties":{"backup_id":{"type":"string","format":"uuid","description":"Unique identifier for the backup (UUID format). Always present.","example":"550e8400-e29b-41d4-a716-446655440000","isRequired":true,"uniqueKey":"backup.items.[INDEX].backup_id","typeLabel":"string\u003cuuid>"},"backup_item_key":{"type":"string","description":"Unique identifier for the backup item (e.g., \"seed_phrase\", \"private_key\", \"wallet_config\"). Present if available from metadata.","example":"seed_phrase","uniqueKey":"backup.items.[INDEX].backup_item_key","typeLabel":"string"},"recovery_id":{"type":"string","format":"uuid","description":"ID of the recovery record. Present if recovery was successful.","example":"660e8400-e29b-41d4-a716-446655440001","uniqueKey":"backup.items.[INDEX].recovery_id","typeLabel":"string\u003cuuid>"},"recovery_package":{"oneOf":[{"type":"object","description":"Recovery package containing the recovered data in encrypted format. Present if recovery was successful. Supports multiple encryption algorithms: GPG, RSA direct, or hybrid RSA-AES256-GCM.","required":["algorithm","data"],"example":{"algorithm":"gpg","data":"LS0tLS1CRUdJTiBQR1AgTUVTU0FHRS0tLS0tCkNpY2VsbGEgZGljdGEgc2VkIGVsZWlmZW5kLi4uCg=="},"properties":{"algorithm":{"type":"string","enum":["gpg"],"description":"Encryption algorithm: GPG encryption/OpenPGP","example":"gpg","isRequired":true,"uniqueKey":"backup.items.[INDEX].recovery_package.oneOf.0.algorithm","typeLabel":"enum\u003cstring>"},"data":{"type":"string","format":"base64","description":"Base64-encoded encrypted data","example":"eyJhbGciOiJSU0EtT0FFUC1TSEEyNTYifQ...","isRequired":true,"uniqueKey":"backup.items.[INDEX].recovery_package.oneOf.0.data","typeLabel":"file"}},"additionalProperties":false,"uniqueKey":"backup.items.[INDEX].recovery_package.oneOf.0","typeLabel":"object"},{"type":"object","description":"Recovery package containing the recovered data in encrypted format. Present if recovery was successful. Supports multiple encryption algorithms: GPG, RSA direct, or hybrid RSA-AES256-GCM.","required":["algorithm","data"],"example":{"algorithm":"rsa-direct","data":"aGVsbG8gd29ybGQgdGhpcyBpcyBhIHNtYWxsIG1lc3NhZ2UgdGhhdCBjYW4gYmUgZW5jcnlwdGVkIGRpcmVjdGx5IHdpdGggUlNB"},"properties":{"algorithm":{"type":"string","enum":["rsa-direct"],"description":"Encryption algorithm: Direct RSA-OAEP encryption for small data","example":"rsa-direct","isRequired":true,"uniqueKey":"backup.items.[INDEX].recovery_package.oneOf.1.algorithm","typeLabel":"enum\u003cstring>"},"data":{"type":"string","format":"base64","description":"Base64-encoded encrypted data","example":"eyJhbGciOiJSU0EtT0FFUC1TSEEyNTYifQ...","isRequired":true,"uniqueKey":"backup.items.[INDEX].recovery_package.oneOf.1.data","typeLabel":"file"}},"additionalProperties":false,"uniqueKey":"backup.items.[INDEX].recovery_package.oneOf.1","typeLabel":"object"},{"type":"object","description":"Recovery package containing the recovered data in encrypted format. Present if recovery was successful. Supports multiple encryption algorithms: GPG, RSA direct, or hybrid RSA-AES256-GCM.","required":["algorithm","data","encryptedKey","iv","tag"],"example":{"algorithm":"hybrid-rsa-aes256-gcm","data":"dGhpcyBpcyBhIGxhcmdlIG1lc3NhZ2UgdGhhdCByZXF1aXJlcyBoeWJyaWQgZW5jcnlwdGlvbi4uLg==","encryptedKey":"YWJjZGVmZ2hpams=","iv":"MTIzNDU2Nzg5MGFi","tag":"YWJjZGVmZ2hpams="},"properties":{"algorithm":{"type":"string","enum":["hybrid-rsa-aes256-gcm"],"description":"Encryption algorithm: Hybrid encryption (AES-256-GCM + RSA-OAEP) for large data","example":"hybrid-rsa-aes256-gcm","isRequired":true,"uniqueKey":"backup.items.[INDEX].recovery_package.oneOf.2.algorithm","typeLabel":"enum\u003cstring>"},"data":{"type":"string","format":"base64","description":"Base64-encoded encrypted data","example":"eyJhbGciOiJSU0EtT0FFUC1TSEEyNTYifQ...","isRequired":true,"uniqueKey":"backup.items.[INDEX].recovery_package.oneOf.2.data","typeLabel":"file"},"encryptedKey":{"type":"string","format":"base64","description":"RSA-encrypted AES key (base64)","example":"rsa-encrypted-aes-key...","isRequired":true,"uniqueKey":"backup.items.[INDEX].recovery_package.oneOf.2.encryptedKey","typeLabel":"file"},"iv":{"type":"string","format":"base64","description":"AES-GCM initialization vector (base64, 12 bytes)","example":"initialization-vector...","isRequired":true,"uniqueKey":"backup.items.[INDEX].recovery_package.oneOf.2.iv","typeLabel":"file"},"tag":{"type":"string","format":"base64","description":"AES-GCM authentication tag (base64, 16 bytes)","example":"authentication-tag...","isRequired":true,"uniqueKey":"backup.items.[INDEX].recovery_package.oneOf.2.tag","typeLabel":"file"}},"additionalProperties":false,"uniqueKey":"backup.items.[INDEX].recovery_package.oneOf.2","typeLabel":"object"}],"uniqueKey":"backup.items.[INDEX].recovery_package","typeLabel":"object"},"original_filename":{"type":"string","description":"Original filename of the backup. Present if recovery was successful and filename was stored.","example":"backup.json","uniqueKey":"backup.items.[INDEX].original_filename","typeLabel":"string"},"content_type":{"type":"string","description":"Content type of the backup. Present if recovery was successful and content type was stored.","example":"application/json","uniqueKey":"backup.items.[INDEX].content_type","typeLabel":"string"},"original_size":{"type":"string","description":"Size of the original backup in bytes. Present if recovery was successful and size was stored.","example":"1024","uniqueKey":"backup.items.[INDEX].original_size","typeLabel":"string"},"metadata":{"type":"object","description":"Metadata associated with the backup. Present if metadata was stored.","additionalProperties":true,"uniqueKey":"backup.items.[INDEX].metadata","typeLabel":"object"},"error":{"type":"string","description":"Error message if recovery failed. Present only if recovery failed.","example":"Backup not found","uniqueKey":"backup.items.[INDEX].error","typeLabel":"string"}},"required":["backup_id"],"uniqueKey":"backup.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"backup","typeLabel":"object[]"}},"required":["backup"],"uniqueKey":"","typeLabel":"object"},"examples":{"gpg_algorithm":{"title":"gpg_algorithm","description":"Example response using GPG encryption algorithm","value":{"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"}]}},"rsa_direct_algorithm":{"title":"rsa_direct_algorithm","description":"Example response using RSA-OAEP direct encryption for small data","value":{"backup":[{"backup_id":"550e8400-e29b-41d4-a716-446655440000","backup_item_key":"private_key","recovery_id":"660e8400-e29b-41d4-a716-446655440001","recovery_package":{"algorithm":"rsa-direct","data":"aGVsbG8gd29ybGQgdGhpcyBpcyBhIHNtYWxsIG1lc3NhZ2UgdGhhdCBjYW4gYmUgZW5jcnlwdGVkIGRpcmVjdGx5IHdpdGggUlNB"},"original_filename":"key.txt","content_type":"text/plain","original_size":"256"}]}},"hybrid_algorithm":{"title":"hybrid_algorithm","description":"Example response using hybrid encryption (AES-256-GCM + RSA-OAEP) for large data","value":{"backup":[{"backup_id":"550e8400-e29b-41d4-a716-446655440000","backup_item_key":"wallet_config","recovery_id":"660e8400-e29b-41d4-a716-446655440001","recovery_package":{"algorithm":"hybrid-rsa-aes256-gcm","data":"dGhpcyBpcyBhIGxhcmdlIG1lc3NhZ2UgdGhhdCByZXF1aXJlcyBoeWJyaWQgZW5jcnlwdGlvbi4uLg==","encryptedKey":"YWJjZGVmZ2hpams=","iv":"MTIzNDU2Nzg5MGFi","tag":"YWJjZGVmZ2hpams="},"original_filename":"wallet.json","content_type":"application/json","original_size":"2048"}]}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"743ed315-8330-474c-b797-bb1ed4412e97":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication and authorization","scopes":[],"schemeName":"ApiKeyAuth"}},"aaf9ae15-3c6f-4cd7-8e13-3ab2cb404657":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"ID token as Bearer token","scopes":[],"schemeName":"BearerAuth"}}},"servers":{"09b732ad-7b39-42ca-8cd8-0ec400b4d2d6":{"url":"https://orchestrator.control.coincover.com","description":"Production server"},"38b2fea1-78de-4e58-b560-28891f607a48":{"url":"https://orchestrator.uat-control.coincover.com","description":"Development server"}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"X-API-Key","description":"API key for authentication and authorization","scopes":[],"schemeName":"ApiKeyAuth"},"schema":{"title":"X-API-Key","type":"string","description":"API key for authentication and authorization","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"X-API-Key"}],"title":"ApiKeyAuth"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"ID token as Bearer token","scopes":[],"schemeName":"BearerAuth"},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"ID token as Bearer token","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"specs/retail.openapi.json"},"subdomain":"coincover","siteName":"Coincover Developer Docs","title":"Recover encrypted backup data - Coincover Developer Docs","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-06T10:08:03.402Z","originalFileLocation":"api-reference/backups/recover-encrypted-backup-data.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Recovers previously stored backup data. Requires successful identity verification (verification_id must be approved/successful). Requires a GPG public key for encrypting the recovered data. Returns an array of backup recovery results, each containing recovery information or error details. This endpoint calls the hot-keys orchestrator recover-backup endpoint for each backup associated with the user.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Coincover Developer Docs\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/coincover/Wnz4s2jyTI4-WRLe/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/coincover/Wnz4s2jyTI4-WRLe/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/coincover/Wnz4s2jyTI4-WRLe/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/coincover/Wnz4s2jyTI4-WRLe/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/coincover/Wnz4s2jyTI4-WRLe/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/coincover/Wnz4s2jyTI4-WRLe/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/coincover/Wnz4s2jyTI4-WRLe/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/coincover/Wnz4s2jyTI4-WRLe/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/coincover/Wnz4s2jyTI4-WRLe/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Recover encrypted backup data - Coincover Developer Docs\">\u003cmeta data-mint-head property=\"og:description\" content=\"Recovers previously stored backup data. Requires successful identity verification (verification_id must be approved/successful). Requires a GPG public key for encrypting the recovered data. Returns an array of backup recovery results, each containing recovery information or error details. This endpoint calls the hot-keys orchestrator recover-backup endpoint for each backup associated with the user.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Coincover Developer Docs\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://developer.coincover.com/api-reference/backups/recover-encrypted-backup-data\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://coincover.mintlify.site/_mintlify/api/og/v2?division=Backups\u0026amp;title=Recover+encrypted+backup+data\u0026amp;description=Recovers+previously+stored+backup+data.+Requires+successful+identity+verification+%28verification_id+must+be+approved%2Fsuccessful%29.+Requires+a+GPG+public+key+for+e\u0026amp;theme=e889e042c90bb80030a3389c\u0026amp;signature=b8d4226e6f8d4822d7426d2f628eafc5656ab98b1b89541b2e36a4eeea181752\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Recover encrypted backup data - Coincover Developer Docs\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Recovers previously stored backup data. Requires successful identity verification (verification_id must be approved/successful). Requires a GPG public key for encrypting the recovered data. Returns an array of backup recovery results, each containing recovery information or error details. This endpoint calls the hot-keys orchestrator recover-backup endpoint for each backup associated with the user.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://coincover.mintlify.site/_mintlify/api/og/v2?division=Backups\u0026amp;title=Recover+encrypted+backup+data\u0026amp;description=Recovers+previously+stored+backup+data.+Requires+successful+identity+verification+%28verification_id+must+be+approved%2Fsuccessful%29.+Requires+a+GPG+public+key+for+e\u0026amp;theme=e889e042c90bb80030a3389c\u0026amp;signature=b8d4226e6f8d4822d7426d2f628eafc5656ab98b1b89541b2e36a4eeea181752\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/coincover/Wnz4s2jyTI4-WRLe/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Coincover Developer Docs\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#3939EF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://developer.coincover.com/api-reference/backups/recover-encrypted-backup-data\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/api-reference/backups/recover-encrypted-backup-data.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://developer.coincover.com/#organization\",\"name\":\"Coincover Developer Docs\",\"url\":\"https://developer.coincover.com\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/coincover/YulmKC25AtRiJdum/images/CC-Logo-Black.svg?fit=max\u0026auto=format\u0026n=YulmKC25AtRiJdum\u0026q=85\u0026s=d81d260390cff9797e850679aeec6841\"}},{\"@type\":\"WebSite\",\"@id\":\"https://developer.coincover.com#website\",\"name\":\"Coincover Developer Docs\",\"url\":\"https://developer.coincover.com\",\"publisher\":{\"@id\":\"https://developer.coincover.com/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://developer.coincover.com/api-reference/backups/recover-encrypted-backup-data#webpage\",\"url\":\"https://developer.coincover.com/api-reference/backups/recover-encrypted-backup-data\",\"name\":\"Recover encrypted backup data\",\"description\":\"Recovers previously stored backup data. Requires successful identity verification (verification_id must be approved/successful). Requires a GPG public key for encrypting the recovered data. Returns an array of backup recovery results, each containing recovery information or error details. This endpoint calls the hot-keys orchestrator recover-backup endpoint for each backup associated with the user.\",\"dateModified\":\"2026-11-06T10:08:03.402Z\",\"isPartOf\":{\"@id\":\"https://developer.coincover.com#website\"},\"breadcrumb\":{\"@id\":\"https://developer.coincover.com/api-reference/backups/recover-encrypted-backup-data#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://developer.coincover.com/api-reference/backups/recover-encrypted-backup-data#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"API Reference\",\"item\":\"https://developer.coincover.com/api-reference/keys/partner--assign-a-new-key-with-environment-specification\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Retail API\",\"item\":\"https://developer.coincover.com/api-reference/verification/start-identity-verification\"},{\"@type\":\"ListItem\",\"position\":3,\"name\":\"Backups\",\"item\":\"https://developer.coincover.com/api-reference/backups/store-encrypted-backup-data\"},{\"@type\":\"ListItem\",\"position\":4,\"name\":\"Recover encrypted backup data\",\"item\":\"https://developer.coincover.com/api-reference/backups/recover-encrypted-backup-data\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://developer.coincover.com/api-reference/backups/recover-encrypted-backup-data#apireference\",\"headline\":\"Recover encrypted backup data\",\"name\":\"Recover encrypted backup data\",\"description\":\"Recovers previously stored backup data. Requires successful identity verification (verification_id must be approved/successful). Requires a GPG public key for encrypting the recovered data. Returns an array of backup recovery results, each containing recovery information or error details. This endpoint calls the hot-keys orchestrator recover-backup endpoint for each backup associated with the user.\",\"url\":\"https://developer.coincover.com/api-reference/backups/recover-encrypted-backup-data\",\"mainEntityOfPage\":{\"@id\":\"https://developer.coincover.com/api-reference/backups/recover-encrypted-backup-data#webpage\"},\"dateModified\":\"2026-11-06T10:08:03.402Z\",\"publisher\":{\"@id\":\"https://developer.coincover.com/#organization\"},\"isPartOf\":{\"@id\":\"https://developer.coincover.com#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Coincover Developer Docs\",\"creator\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","siteName":"Coincover Developer Docs","nav":{"global":null,"tabs":[{"tab":"Get Started","pages":[{"title":"Get Started","href":""}]},{"tab":"Products","pages":[{"title":"Products","href":"/wallet-provider-recovery/overview"}]},{"tab":"Partners","pages":[{"title":"Partners","href":"/partner-guides/overview"}]},{"tab":"Guides","pages":[{"title":"Guides","href":"/guides/validating-key-signatures"}]},{"tab":"API Reference","groups":[{"group":"API Reference","pages":[{"group":"Wallet Provider API","pages":[{"group":"Keys","pages":[{"title":"Partner - Assign a new key with environment specification","deprecated":null,"version":null,"openapi":"/specs/wallet-provider.openapi.json post /v1/partner/keys","href":"/api-reference/keys/partner--assign-a-new-key-with-environment-specification"}]},{"group":"Backups","pages":[{"title":"Partner - Store secure encrypted data","deprecated":null,"version":null,"openapi":"/specs/wallet-provider.openapi.json post /v1/partner/secure/data","href":"/api-reference/backups/partner--store-secure-encrypted-data"},{"title":"Partner - Store secure encrypted files","deprecated":null,"version":null,"openapi":"/specs/wallet-provider.openapi.json post /v1/partner/secure/file","href":"/api-reference/backups/partner--store-secure-encrypted-files"}]}]},{"group":"Institutional API","pages":[{"group":"Keys","pages":[{"title":"Assign a new key","deprecated":null,"version":null,"openapi":"/specs/institutional.openapi.json post /v1/keys","href":"/api-reference/keys/assign-a-new-key"},{"title":"Verify a key's integrity","deprecated":null,"version":null,"openapi":"/specs/institutional.openapi.json get /v1/keys/{keyId}/verify","href":"/api-reference/keys/verify-a-keys-integrity"}]},{"group":"Backups","pages":[{"title":"Store secure encrypted data","deprecated":null,"version":null,"openapi":"/specs/institutional.openapi.json post /v1/secure/data","href":"/api-reference/backups/store-secure-encrypted-data"},{"title":"Store secure encrypted files","deprecated":null,"version":null,"openapi":"/specs/institutional.openapi.json post /v1/secure/file","href":"/api-reference/backups/store-secure-encrypted-files"},{"title":"Verify a backup's integrity","deprecated":null,"version":null,"openapi":"/specs/institutional.openapi.json get /v1/backups/{backupId}/verify","href":"/api-reference/backups/verify-a-backups-integrity"}]}]},{"group":"Retail API","pages":[{"group":"Verification","pages":[{"title":"Start identity verification","deprecated":null,"version":null,"openapi":"/specs/retail.openapi.json post /v1/verification/start","href":"/api-reference/verification/start-identity-verification"},{"title":"Get verification status","deprecated":null,"version":null,"openapi":"/specs/retail.openapi.json get /v1/verification/{verification_id}/status","href":"/api-reference/verification/get-verification-status"},{"title":"Simulate biometric verification events","deprecated":null,"version":null,"openapi":"/specs/retail.openapi.json post /v1/verification/simulate","href":"/api-reference/verification/simulate-biometric-verification-events"}]},{"group":"Keys","pages":[{"title":"Generate a cryptographic key","deprecated":null,"version":null,"openapi":"/specs/retail.openapi.json post /v1/key/generate","href":"/api-reference/keys/generate-a-cryptographic-key"}]},{"group":"Backups","pages":[{"title":"Store encrypted backup data","description":"Stores encrypted backup data securely. Accepts multiple backup items in a single request via the backup array (limited to a maximum of 3 items). Requires a verification_id that exists in the identity_verifications table and belongs to the user associated with the organisation. Each backup item's item_key (e.g., \"seed_phrase\", \"private_key\") is stored in the hot-keys database metadata as backup_item_key for recovery operations. This endpoint calls the hot-keys orchestrator partner-secure-data endpoint.","deprecated":null,"version":null,"openapi":"/specs/retail.openapi.json post /v1/backup/store","href":"/api-reference/backups/store-encrypted-backup-data"},{"title":"Recover encrypted backup data","deprecated":null,"version":null,"openapi":"/specs/retail.openapi.json post /v1/backup/recover","href":"/api-reference/backups/recover-encrypted-backup-data"}]}]},{"group":"Updates","pages":[{"title":"Changelog","description":"New features, fixes, and improvements to CoinCover.","mode":"wide","href":"/changelog/changelog"}]}]}]}]},"basePath":"","title":"Recover encrypted backup data - Coincover Developer Docs","buildId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","deploymentId":"dpl_DTau1J5HqS9UTgVSDwGksstFWtPa","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-5FCzAcfS.js","utils-SLtAG4EZ.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-2DZi8ZMu.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema-D7J3nkzE.js","snippetPresets-D0Alv0AH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-BI4qNJ2c.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-BD3uyr8j.js","shallow-D8iEBr5z.js","getApiPlaygroundDisplay-CgNP4lzR.js","CodeSnippet-CX-QHuMs.js","CodeSnippets-VlXE-ZUf.js","Page-D9ithiIZ.js","getPastedJson-DYNQkZ1M.js","icon-CzacdwOi.js","MethodPill-2JVqoYKi.js","DuplicateIcon-_xVXs-U8.js","createIcon-BRHrweLo.js","DynamicMarkdown-mQG_iQiE.js","SectionHeading-DMpJzv8f.js","axios-vUo_bRtp.js","Markdown-5FGIym-8.js","clsx-D-TRO5q5.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-CdrJecqK.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-CHlcWBLM.js"]}