---
title: "List vault items"
method: GET
path: "/v1/vault/items"
tags: ["Vault"]
---

# List vault items

`GET /v1/vault/items`

## Request

- Base URL: `https://agent.tinyfish.ai`
- URL: `https://agent.tinyfish.ai/v1/vault/items`
- Auth: API key in header `X-API-Key`

List all vault items currently available from connected providers.

## Response `200`

Vault items retrieved successfully.

- object
  - `items` object[], required
    - `itemId` string, required
    - `connectionId` string, nullable, required
    - `label` string, required
    - `vaultName` string, required
    - `domains` string[], required
    - `fieldMetadata` object[], required
      - `fieldId` string, required
      - `label` string, required
      - `type` 'STRING' | 'CONCEALED' | 'OTP', required
    - `hasTotp` boolean, required

## Other responses

- `401`: Unauthorized - Invalid or missing API key
- `404`: No vault connection found.
- `500`: Internal server error
- `503`: Vault feature is not enabled

---

[API](https://skmtc.dev/tinyfish/apis/tinyfish-web-agent-automation-api-2.md) · [All operations](https://skmtc.dev/tinyfish/apis/tinyfish-web-agent-automation-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/tinyfish/apis/tinyfish-web-agent-automation-api-2/revisions/c48ef855099d?raw)