Privicore
  1. Data Token
Privicore
  • Privicore API
  • Utility
    • Utility
    • Check server health
      GET
    • Request command id status
      GET
  • Profile
    • Profile Model and Authentication Workflow
    • Register new profile
      POST
    • Authenticate
      POST
    • Retrieve profile id
      GET
    • Change password
      POST
    • Generate qr token for authorization
      POST
    • Reauthorize authorization token
      POST
    • Revoke authorization token
      POST
    • Retrieve token expiry
      POST
  • OAuth Application
    • OAuth Application Management
    • Register OAuth Application
      POST
    • Retrieve OAuth app configuration
      POST
    • Request OAuth app authorization code
      GET
    • Retrieve OAuth app authorization code
      POST
    • Obtain OAuth app access token
      POST
    • OAuth application list
      GET
    • Retrieve OAuth application scope
      GET
    • Refresh OAuth app access token
      POST
  • Public key
    • Public and Private Key Management
    • Generate your private and public keys
    • Register public key
    • Retrieve public key
    • Retrieve CAB public key
  • Data Token
    • Data Token Management
    • Reserve token space
      POST
    • Retrieve temporary data token
      GET
    • Exchange data for token
      POST
    • Upstream file via stream auth
      POST
    • Request data via token
      POST
    • Download data
      GET
    • Configure information security risk meta
      POST
    • Configure file meta
      POST
    • List data tokens
      GET
    • Update data token
      POST
    • Delete data
      POST
  • Device
    • Device Management
    • Request unique identifier (i.e. Register new device)
    • Retrieve unique identifier
    • Retrieve profile devices
    • Configure device meta
    • Approve device
    • Reject device
    • Retrieve device configuration
    • Remove device
  • Storage
    • Storage Device Management
    • Register storage device
    • List storage devices
    • Synchronize device
    • Remove storage
  • Verified authenticator
    • Authenticator and Voting Management
    • Register authenticator
    • List verified authenticators
    • Retrieve voting strategy
    • Set quorum size
    • Set quorum strategy
    • Set voting time limit
    • Set maximum voting attempts
    • Remove authenticator
    • Register voting configuration
    • Update voting configuration
    • List voting configurations
    • Retrieve voting configuration
  • Policy
    • List policy templates
    • Register policy
    • List active policies
    • List inactive policies
    • Activate policy
    • Deactivate policy
    • Delete policy
    • List registered policies
    • Retrieve registered policy
  • Directory
    • Register Directory
    • Retrieve owned Directories
    • Retrieve assigned directories
    • Retrieve Directory
    • Create Directory User
    • Update user information
    • Invite Profile
    • Set profile password
    • List Directory Invites
    • Process Invitation
    • Retrieve directory profile
    • List directory users
    • Directory profiles info
    • Create profile device
    • Add storage device to profile
    • List directory devices
    • Create directory voting pool
    • Store directory meta information
  • Voting
    • Create voting
    • Check pool status
  • Schemas
    • Response
      • CommandAccepted
      • Unauthorized
      • ValidationErrors
    • Schemas
    • profileId
    • deviceIdentifier
    • directoryId
    • directoryName
    • directoryShortName
    • givenName
    • familyName
    • createdAt
    • meta
  1. Data Token

Download data

GET
/

Overview#

Download the retrieved data using a downstream authentication token. This completes the data retrieval process initiated by the request data endpoint.

Download Data#

Endpoint: GET /
Authentication: Required (Downstream authentication token as query parameter)

Query Parameters#

ParameterTypeRequiredDescription
authstringYesDownstream authentication token for retrieving the data

Response#

The response contains the encrypted data that must be decrypted locally by the application using its private key.
Full URL Format:
{download_server_id}:{download_server_port}/?auth={downstream_authentication_token}

Use Case#

After requesting data via token, use this endpoint to download the actual data. The download server details and authentication token are provided in the response from the request data endpoint.
The data you receive is still encrypted with your application's public key (the final layer). You must decrypt it locally using your application's private key to access the original plaintext data. This completes the reverse decryption chain: Device → Privicore → Application.
Downstream authentication token is single-use and tied to the specific data request
Data received is encrypted and requires local decryption with your private key
The download server may be separate from the main Privicore API server
Token validity and download availability may have time limits

Request

Query Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://sandbox.privicore.com:9009/?auth'

Responses

🟢200Success
text/plain
File downloaded successfully
Headers

Body

Example
"string"
Modified at 2025-12-22 10:34:09
Previous
Request data via token
Next
Configure information security risk meta
Built with