---
title: "Retrieves events for each usage of an item stored in a shared vault within a 1Password account"
method: POST
path: "/api/v1/itemusages"
tags: ["api-v1"]
---

# Retrieves events for each usage of an item stored in a shared vault within a 1Password account

`POST /api/v1/itemusages`

This endpoint requires your JSON Web Token to have the *itemusages* feature.

## Request body

- union
  - Cursor — Cursor
    - `cursor` string — Cursor to fetch more data if available or continue the polling process if required
  - ResetCursor — Reset cursor
    - `limit` number
    - `start_time` string, date-time
    - `end_time` string, date-time

## Response `200`

Item usages response object

- ItemUsageItems — Cursor
  - `items` ItemUsage[]
    - `uuid` string
    - `timestamp` string, date-time
    - `used_version` integer
    - `vault_uuid` string
    - `item_uuid` string
    - `action` 'fill' | 'select-sso-provider' | 'enter-item-edit-mode' | 'export' | 'share' | 'secure-copy' | 'reveal' | 'server-create' | 'server-update' | 'server-fetch'
    - `user` User — User object
      - `uuid` string
      - `name` string — Full name
      - `email` string, email
    - `client` Client — Metadata gathered about the client
      - `app_name` string
      - `app_version` string
      - `platform_name` string
      - `platform_version` string — Depending on the platform used, this can be the version of the browser that the client extension is installed, the model of computer that the native application is installed or the machine's CPU version that the CLI was installed
      - `os_name` string
      - `os_version` string
      - `ip_address` string
    - `location` Location — Geolocation Info about the client
      - `country` string
      - `region` string
      - `city` string
      - `longitude` number
      - `latitude` number
  - `cursor` string — Cursor to fetch more data if available or continue the polling process if required
  - `has_more` boolean — Whether there may still be more data to fetch using the returned cursor. If true, the subsequent request could still be empty.

## Other responses

- `401` — Unauthorized
- `500` — Internal Server Error
- `default` — Generic error

---

[API](https://skmtc.dev/1password/apis/events-api.md) · [All operations](https://skmtc.dev/1password/apis/events-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/1password/events-api/revisions/359da8b22780/schema)