Skip to main content

Retrieve Records

To retrieve records from SecretVault, fetch data from your cluster's nodes, then decrypt any encrypted fields using nilQL to reconstruct the original data.

1. Check Your Collection for the Schema ID​

List available Collections using the List Schemas endpoint (GET /schemas) to get the Schema ID of the collection you want to store your data in.

2. Retrieve Records​

Retrieve records from a collection by calling the Read Data endpoint (POST /data/read) with the schema id and optionally a filter. If you don't pass in a filter, all records will be returned.

Example POST /data/read Payload
{
   "schema": "9b22147f-d6d5-40f1-927d-96c08XXXXXXXX",
   "filter": {
      "service": "Netflix"
   }
}
Code Samples
nildb/secretvault_python/nildb_api.py
loading...

Retrieved records will have:

  • Plaintext fields with identical values across nodes
  • Encrypted fields as shares that need nilQL to decrypt and reconstruct values from all nodes