# Have I Been Pwned

> Look up data breaches in Have I Been Pwned: list and read breaches, filtered by site, data exposed and date, and check which breaches an email address is in. Start a workflow for each new breach.

App · 4 actions. Web page: https://docs.lodol.com/docs/integrations/have-i-been-pwned

## Actions

### Check email address

Find the breaches an email address appears in, and whether any exposed a password. Needs an HIBP API key on the connection.

**Inputs**

- Email address (`email`, text, required): The address to check.
- Include unverified breaches (`include_unverified`, true/false): Include breaches HIBP has not confirmed. On by default. Default: `true`.

**Outputs**

- `breaches` (list): The breaches, most recent first
- `count` (number): How many breaches
- `email` (text): The address checked
- `found` (true/false): True when it is in any breach
- `passwords_exposed` (true/false): True when any of them exposed passwords

**Example output**

```json
{
  "breaches": [
    {
      "added_at": "2013-12-04T00:00:00Z",
      "breach_date": "2013-10-04",
      "data_classes": [
        "Email addresses",
        "Password hints",
        "Passwords",
        "Usernames"
      ],
      "description": "In October 2013, 153 million Adobe accounts were breached.",
      "domain": "adobe.com",
      "is_fabricated": false,
      "is_malware": false,
      "is_sensitive": false,
      "is_spam_list": false,
      "is_stealer_log": false,
      "is_verified": true,
      "logo_url": "https://logos.haveibeenpwned.com/Adobe.png",
      "modified_at": "2022-05-15T23:52:49Z",
      "name": "Adobe",
      "pwn_count": 152445165,
      "title": "Adobe",
      "url": "https://haveibeenpwned.com/Breach/Adobe"
    }
  ],
  "count": 1,
  "email": "jo@example.com",
  "found": true,
  "passwords_exposed": true
}
```

### Get breach

Get one breach: when it happened, how many accounts and what data it exposed.

**Inputs**

- Breach (`breach`, text, required): The breach. Pick one, or give its name from an earlier step.

**Outputs**

- `added_at` (text): When HIBP added it, in UTC (ISO 8601)
- `breach_date` (text): When the breach happened (YYYY-MM-DD)
- `data_classes` (list): The kinds of data exposed, such as Email addresses and Passwords
- `description` (text): What happened, as plain text
- `domain` (text): The site's domain; empty when there is none
- `is_fabricated` (true/false): True when the data is believed to be made up
- `is_malware` (true/false): True when the data came from malware
- `is_sensitive` (true/false): True when being in it could harm a person, so HIBP hides it from public searches
- `is_spam_list` (true/false): True for a spam list rather than a breach of a site
- `is_stealer_log` (true/false): True when the data came from information-stealing malware logs
- `is_verified` (true/false): True when HIBP has confirmed the breach is real
- `logo_url` (text): The site's logo
- `modified_at` (text): When HIBP last changed it, in UTC (ISO 8601)
- `name` (text): HIBP's name for the breach, such as Adobe
- `pwn_count` (number): How many accounts it exposed
- `title` (text): The breach's title
- `url` (text): The breach's page on Have I Been Pwned

**Example output**

```json
{
  "added_at": "2013-12-04T00:00:00Z",
  "breach_date": "2013-10-04",
  "data_classes": [
    "Email addresses",
    "Password hints",
    "Passwords",
    "Usernames"
  ],
  "description": "In October 2013, 153 million Adobe accounts were breached.",
  "domain": "adobe.com",
  "is_fabricated": false,
  "is_malware": false,
  "is_sensitive": false,
  "is_spam_list": false,
  "is_stealer_log": false,
  "is_verified": true,
  "logo_url": "https://logos.haveibeenpwned.com/Adobe.png",
  "modified_at": "2022-05-15T23:52:49Z",
  "name": "Adobe",
  "pwn_count": 152445165,
  "title": "Adobe",
  "url": "https://haveibeenpwned.com/Breach/Adobe"
}
```

### Get latest breach

Get the breach HIBP added most recently.

**Inputs**: None.

**Outputs**

- `added_at` (text): When HIBP added it, in UTC (ISO 8601)
- `breach_date` (text): When the breach happened (YYYY-MM-DD)
- `data_classes` (list): The kinds of data exposed, such as Email addresses and Passwords
- `description` (text): What happened, as plain text
- `domain` (text): The site's domain; empty when there is none
- `is_fabricated` (true/false): True when the data is believed to be made up
- `is_malware` (true/false): True when the data came from malware
- `is_sensitive` (true/false): True when being in it could harm a person, so HIBP hides it from public searches
- `is_spam_list` (true/false): True for a spam list rather than a breach of a site
- `is_stealer_log` (true/false): True when the data came from information-stealing malware logs
- `is_verified` (true/false): True when HIBP has confirmed the breach is real
- `logo_url` (text): The site's logo
- `modified_at` (text): When HIBP last changed it, in UTC (ISO 8601)
- `name` (text): HIBP's name for the breach, such as Adobe
- `pwn_count` (number): How many accounts it exposed
- `title` (text): The breach's title
- `url` (text): The breach's page on Have I Been Pwned

**Example output**

```json
{
  "added_at": "2013-12-04T00:00:00Z",
  "breach_date": "2013-10-04",
  "data_classes": [
    "Email addresses",
    "Password hints",
    "Passwords",
    "Usernames"
  ],
  "description": "In October 2013, 153 million Adobe accounts were breached.",
  "domain": "adobe.com",
  "is_fabricated": false,
  "is_malware": false,
  "is_sensitive": false,
  "is_spam_list": false,
  "is_stealer_log": false,
  "is_verified": true,
  "logo_url": "https://logos.haveibeenpwned.com/Adobe.png",
  "modified_at": "2022-05-15T23:52:49Z",
  "name": "Adobe",
  "pwn_count": 152445165,
  "title": "Adobe",
  "url": "https://haveibeenpwned.com/Breach/Adobe"
}
```

### List breaches

List the data breaches HIBP holds, most recently added first: every one, one site's, those exposing certain data such as passwords, or those added after a date.

**Inputs**

- Domain (`domain`, text): Only breaches of this site, such as adobe.com.
- Exposing (`data_classes`, list): Only breaches that exposed any of these kinds of data.
- Added after (`added_after`, date): Only breaches HIBP added after this date.
- Include spam lists (`include_spam_lists`, true/false): Include spam lists, which are not breaches of a site. On by default. Default: `true`.
- Limit (`limit`, number): The most to return, up to 1000. Defaults to 50. From 1 to 1000.

**Outputs**

- `breaches` (list): The breaches, most recently added first
- `count` (number): How many were returned
- `total_accounts` (number): Accounts exposed across all that match
- `total_count` (number): How many match in all

**Example output**

```json
{
  "breaches": [
    {
      "added_at": "2013-12-04T00:00:00Z",
      "breach_date": "2013-10-04",
      "data_classes": [
        "Email addresses",
        "Password hints",
        "Passwords",
        "Usernames"
      ],
      "description": "In October 2013, 153 million Adobe accounts were breached.",
      "domain": "adobe.com",
      "is_fabricated": false,
      "is_malware": false,
      "is_sensitive": false,
      "is_spam_list": false,
      "is_stealer_log": false,
      "is_verified": true,
      "logo_url": "https://logos.haveibeenpwned.com/Adobe.png",
      "modified_at": "2022-05-15T23:52:49Z",
      "name": "Adobe",
      "pwn_count": 152445165,
      "title": "Adobe",
      "url": "https://haveibeenpwned.com/Breach/Adobe"
    }
  ],
  "count": 1,
  "total_accounts": 152445165,
  "total_count": 1
}
```
