---
title: "Get a vault"
method: GET
path: "/vaults/{vault_id}"
tags: ["Vault"]
---

# Get a vault

`GET /vaults/{vault_id}`

Returns a vault, in a vault are the encrypted credentials

## Path parameters

- `vault_id` integer, required

## Response `200`

An array of vaults

- Credential[]
  - `item_id` integer — generated by uniqid()
  - `user_id` string
  - `vault` integer — The id of the vault the item belongs to
  - `label` string — Name of the item
  - `description` string — Description the user has given to the item
  - `created` string, dateTime — Time the item was created
  - `changed` string, dateTime — Time the item was changed
  - `tags` Tag[]
    - `tag_id` integer
    - `name` string
  - `email` string — Saved e-mail
  - `username` string — Saved username
  - `password` string — The stored password, encrypted with sjcl
  - `url` string — Saved url of the item
  - `favicon` string — Fav icon from the url
  - `renew_interval` integer — x
  - `expire_time` string, dateTime — Timestamp when the password expires, set NULL to not expire items
  - `delete_time` string, dateTime — If an item is deleted this contains the timestamp, else it's 0
  - `files` File[] — An array containing encrypted files
    - `file_id` integer — The file id, generated by uniqid()
    - `filename` string — The uploaded file name
    - `guid` string — The guid of the file
    - `size` integer — Size of the file in bytes
    - `file_data` string — sjcl encrypted file (only given when downloading a file)
    - `created` string, dateTime
  - `custom_fields` CustomField[] — An array of user defined fields
    - `label` string — Label of the custom field
    - `value` string — Value of the custom field
  - `otp` object — This field holds the One Time Password data
    - `otp_secret` string
    - `qr_uri` string

## Other responses

- `default` — Unexpected error

---

[API](https://skmtc.net/nextcloud/apis/passman-api.md) · [All operations](https://skmtc.net/nextcloud/apis/passman-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nextcloud/passman-api/versions/79e52d7d686a/schema)