Privicore
  1. Storage
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
    • Retrieve temporary data token
    • Exchange data for token
    • Upstream file via stream auth
    • Request data via token
    • Download data
    • Configure information security risk meta
    • Configure file meta
    • List data tokens
    • Update data token
    • Delete data
  • 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
      POST
    • List storage devices
      GET
    • Synchronize device
      POST
    • Remove storage
      POST
  • 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. Storage

List storage devices

GET
/storage/list-storage-devices

Overview#

Retrieve a paginated list of all Storage devices registered under your profile.

List Storage Devices#

Endpoint: GET /storage/list-storage-devices
Authentication: Required (Authorization token obtained from the step)

Query Parameters#

ParameterTypeRequiredDescription
pageintegerNoPage number for pagination
perPageintegerNoNumber of devices per page

Use Case#

Use this endpoint to retrieve all devices registered as Storage under your profile. The response includes device identifiers, metadata, and status information for each Storage device. This is useful for:
Auditing which devices are actively storing your data
Managing Storage device lifecycle
Monitoring distributed storage infrastructure
Identifying devices for synchronization or removal
Only Storage devices are returned - use retrieve profile devices for all device types
Use pagination for profiles with large numbers of Storage devices
Response includes device configuration and operational status

Request

Authorization
API Key
Add parameter in header
X-DPT-AUTHORIZATION
Example:
X-DPT-AUTHORIZATION: ********************
or
Query Params

Header 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/storage/list-storage-devices?page&perPage' \
--header 'X-DPT-AUTHORIZATION: <api-key>'

Responses

🟢200Success
application/json
OK
Body

Example
{
    "items": [
        {
            "deviceIdentifier": "example_device_identifier",
            "profileId": "example_owner_profile",
            "status": 1,
            "metaName": "meta_name_example",
            "metaSecurityLabel": [
                "string"
            ],
            "createdAt": "2025-02-10T10:03:06+00:00"
        }
    ],
    "meta": {
        "page": 1,
        "perPage": 25,
        "count": 1,
        "maxPage": 1
    }
}
🟠401401
🟠422422
Modified at 2025-12-25 10:09:05
Previous
Register storage device
Next
Synchronize device
Built with