Events API API

by 1password.com

Bearer tokenHTTPSSecurity

Overview

1Password Events API Specification.

Events API is a security API from 1password.com. Requests are authenticated with a bearer token. It is served over HTTPS. Its OpenAPI description documents 3 endpoints.

At a glance

Authentication: Bearer token
HTTPS: Yes
CORS: Unknown
Category: Security
Base URL: https://events.1password.com
Version: 1.0.0
Endpoints: 3
OpenAPI: Specification ↗
Spec updated: 2023-02-27

Make a first request

Replace the placeholders; the documentation says exactly where credentials go.

cURL

curl -X GET "https://events.1password.com/api/auth/introspect" \
  -H "Accept: application/json" \
  -H "Authorization: Bearer YOUR_TOKEN"

JavaScript

const response = await fetch("https://events.1password.com/api/auth/introspect", {
  method: "GET",
  headers: {
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
  },
});
const data = await response.json();
console.log(data);

Python

import requests

response = requests.request(
    "GET",
    "https://events.1password.com/api/auth/introspect",
    headers={
    "Accept": "application/json",
    "Authorization": "Bearer YOUR_TOKEN",
    },
    timeout=30,
)
print(response.json())

Endpoints

Method	Path	What it does
GET	`/api/auth/introspect`	Performs introspection of the provided Bearer JWT token
POST	`/api/v1/itemusages`	Retrieves item usages
POST	`/api/v1/signinattempts`	Retrieves sign-in attempts

Questions

Does the Events API API need an API key?

Yes. The Events API API uses Bearer token authentication; the documentation explains how to get credentials.

Does the Events API API support HTTPS?

Yes, the Events API API is served over HTTPS.

How many endpoints does the Events API API have?

Its OpenAPI description lists 3 endpoints in version 1.0.0. All of them are shown on this page.

What are alternatives to the Events API API?

Other Security APIs include Microsoft Security Response Center (MSRC), National Vulnerability Database, Cisco PSIRT openVuln API, Shodan, BitWarden.

Compare alternatives →

Microsoft Security Response Center (MSRC)

Security

Programmatic interfaces to engage with the Microsoft Security Response Center (MSRC)

No auth

National Vulnerability Database

Security

U.S. National Vulnerability Database

No auth

Cisco PSIRT openVuln API

Security

The Cisco Product Security Incident Response Team (PSIRT) openVuln API is a RESTful API that allows customers to obtain Cisco Security Vulnerability information in different machine-consumable formats. APIs are important for customers because they allow their technical staff and programmers to build tools that help them do their job more effectively (in this case, to keep up with security vulnerability information). For more information about the Cisco PSIRT openVuln API visit https://developer.cisco.com/site/PSIRT/discover/overview For detail steps on how to use the API go to:https://developer.cisco.com/site/PSIRT/get-started/getting-started.gsp This is a beta release of a swagger YAML for the Cisco PSIRT openVuln API To access the API sign in with your Cisco CCO account at http://apiconsole.cisco.com and register an application to recieve a client_id and a client_secret You can then get your token using curl or any other method you prefer. 'curl -s -k -H "Content-Type: application/x-www-form-urlencoded" -X POST -d "client_id=<your_client_id>" -d "client_secret=<your_client_secret>" -d "grant_type=client_credentials" https://cloudsso.cisco.com/as/token.oauth2' You will receive an access token as demonstrated in the following example: '{"access_token":"I7omWtBDAieSiUX3shOxNJfuy4J6","token_type":"Bearer","expires_in":3599}' In Swagger, click on Change Authentication enter the text "I7omWtBDAieSiUX3shOxNJfuy4J6" (which is the token you received) then click on "Try this operation"

OAuth19 endpoints