List vaults and items using 1Password SDKs

You can use 1Password SDKs to list vaults and items in a 1Password account. This is helpful if you need to get the unique identifier (ID) for an item or vault. Before you begin, follow the steps to get started with a 1Password SDK.

See the examples folder in the 1Password Go, JavaScript, or Python SDK GitHub repository for example code you can quickly clone and test in your project.

List vaults

Go
JavaScript
Python

The client.Vaults.List function gets all vaults in an account.

vaults, err := client.Vaults().List(context.Background())
if err != nil {
	panic(err)
}
for _, vault := range vaults {
	fmt.Printf("%+v\n", vault)
}

The client.vaults.list function gets all vaults in an account.

const vaults = await client.vaults.list();
for (const vault of vaults) {
  console.log(vault);
}

The client.vaults.list function gets all vaults in an account.

vaults = await client.vaults.list()
for vault in vaults:
    print(vault)

List items

Go
JavaScript
Python

The client.Items.List function gets all items in a vault and can return each item’s ID, title, category, state, and the ID of the vault where it’s stored. It only returns active items by default. The example below returns item IDs.To list items, specify a vault ID, or pass a vault ID from the output of an item or the output of client.Vaults.List.

overviews, err := client.Items().List(context.Background(), vaultID)
if err != nil {
	panic(err)
}
for _, overview := range overviews {
	fmt.Printf("%s %s\n", overview.ID, overview.Title)
}

The client.items.list function gets all items in a vault and can return each item’s ID, title, category, state, and the ID of the vault where it’s stored. It only returns active items by default. The example below returns item IDs.To list items, specify a vault ID, or pass a vault ID from the output of an item or the output of client.vaults.list.

const overviews = await client.items.list(vaultId);
for (const overview of overviews) {
  console.log(overview.id + " " + overview.title);
}

overviews = await client.items.list(vault.id)
for overview in overviews:
    print(overview.title)

Filter listed items by state

You can filter listed items by their state: Active or Archived.

Go
JavaScript
Python

To filter listed items so only archived items are returned:

archivedOverviews, err := client.Items().List(context.Background(), vaultID,
	onepassword.NewItemListFilterTypeVariantByState(
		&onepassword.ItemListFilterByStateInner{
			Active:   false,
			Archived: true,
		},
	),
)
if err != nil {
	panic(err)
}
for _, overview := range archivedOverviews {
	fmt.Printf("%s %s\n", overview.ID, overview.Title)
}

To filter listed items so only archived items are returned:

const archivedOverviews = await client.items.list(vaultId, {
  type: "ByState",
  content: { active: false, archived: true },
});
for (const overview of archivedOverviews) {
  console.log(overview.id + " " + overview.title);
}

To filter listed items so only archived items are returned:

archived_overviews = await client.items.list(
    vault.id,
    ItemListFilterByState(
        content=ItemListFilterByStateInner(active=False, archived=True)
    ),
)
for overview in archived_overviews:
    print(overview.title)

SDKs

​List vaults

​List items

​Filter listed items by state

​Learn more

List vaults

List items

Filter listed items by state

Learn more