> For the complete documentation index, see [llms.txt](https://docs.whiteintel.io/whiteintel-api-doc/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.whiteintel.io/whiteintel-api-doc/whiteintel-api-v1/infostealer-api/password-leaks-api.md).

# Password Leaks API

## Description

The Password Leaks API allows users to check if a specified password was found in breaches. The request must include the query parameter and apikey. 

## Endpoint

`POST /api/get_password_leaks.php`

## Required Headers

| Name         | Description                       |
| ------------ | --------------------------------- |
| Content-Type | Must be set to `application/json` |

## Parameters

<table><thead><tr><th width="474">Name</th><th width="141">Type</th><th>Required</th><th>Default</th><th>Description</th></tr></thead><tbody><tr><td>query</td><td>string</td><td>Yes</td><td>N/A</td><td>Password value you wanted to check to detect if it has been seen in leaks.</td></tr><tr><td>apikey</td><td>string</td><td>Yes</td><td>N/A</td><td>Your API key.</td></tr></tbody></table>

## Sample Request

### Request URL

POST /api/get\_password\_leaks.php

```json
{
    "query": "12345",
    "apikey": "yourapikey"
}
```

### Example Success Response

```json
{"breached":true}
```

### Example Error Response

```json
{"error":"Invalid type."}
```

## Code Examples

Example with Curl

```bash
curl -X POST https://whiteintel.io/api/get_password_leaks.php \
     -H "Content-Type: application/json" \
     -d '{
           "apikey": "yourapikey",
           "query": "12345"
         }'
```

Example with Python

```python

import requests

url = "https://whiteintel.io/api/get_password_leaks.php"
payload = {
    "apikey": "yourapikey",
    "query": "12345"
}
headers = {
    "Content-Type": "application/json"
}

response = requests.post(url, json=payload, headers=headers)

if response.status_code == 200:
    print("Response:", response.json())
else:
    print("Failed to retrieve customer leaks:", response.status_code, response.text)

```