API documentation

GET /secret_items/:id

Authorization Required

https://[your-subdomain].trackdrive.com/api/v1/secret_items/:id

Get Secret by id.

Returns a single Secret by id. Only its encrypted ciphertext and blind index are exposed, not the plain text value.

Example Request

curl 'https://[your-subdomain].trackdrive.com/api/v1/secret_items/10001' \
  -H 'Authorization: Basic BASE64_ENCODED_PUBLIC_KEY_AND_PRIVATE_KEY'

Example Response 200

{
  "status": 200,
  "success": true,
  "errors": {},
  "secret_item": {
    "id": 10001,
    "type": "SecretItem",
    "uuid": null,
    "created_at": "2026-01-15T15:30:00.000Z",
    "updated_at": "2026-01-15T15:30:00.000Z",
    "deleted_at": null,
    "user_updated_at": null,
    "routes_show_path": null,
    "routes_edit_path": "/secret_items/10001/edit",
    "external_record_id": null,
    "company_id": 10002,
    "key": "auth_token",
    "value": "exam**************ue-2",
    "description": "Example auth token",
    "token_replacement_example": "[secret_auth_token]"
  },
  "metadata": {
    "root": "secret_item"
  }
}