Endpoints

Endpoint structure

Each API endpoint starts with a base URL, followed by the resource or operation path:

Replace the base_url placeholder with the appropriate URL for your 1Password account and use the path of the operation or resource you want to access: introspect, auditevents, itemusages, or signinattempts.

For example, if your 1Password account is hosted on ent.1password.com and you want to retrieve a list of audit events, you would use the following URL to make a call to the auditevents endpoint:

Endpoint versions

The Events API supports both V1 and V2 endpoints for audit events, item usages, and sign-in attempts. The V2 endpoints in this reference provide additional information about users and accounts for managed service providers (MSPs). V1 endpoints remain fully supported for existing integrations that don't require the additional MSP account and user type information.

Choose the appropriate version based on your needs:

• Use V2 endpoints if you need MSP-related event data or if you're just starting with the Events API.
• Use V1 endpoints if you have existing integrations and you don't require the additional MSP data.

See the API changelog to learn more about the changes in the V2 endpoints and previous versions of the API.