---
title: "Get Domain Breaches"
method: POST
path: "/v1/domain-breaches"
tags: ["domain_breaches"]
---

# Get Domain Breaches

`POST /v1/domain-breaches`

## Request

- Base URL: `https://api.xposedornot.com`
- URL: `https://api.xposedornot.com/v1/domain-breaches`
- Auth: none declared. Required headers: `x-api-key`

Retrieves information about data breaches associated with verified domains for an API key. This endpoint provides detailed metrics and statistics about breaches affecting the domains.

## Headers

- `x-api-key` string, required

## Response `200`

Successfully retrieved domain breaches

- object
  - `status` string: Response status
  - `metrics` object: Detailed metrics about domain breaches
    - `Yearly_Metrics` object: Breach counts by year
    - `Domain_Summary` object: Summary of breaches by domain
    - `Breach_Summary` object: Summary of all breaches
    - `Breaches_Details` object[]: Detailed information about each breach
      - `email` string
      - `domain` string
      - `breach` string
    - `Top10_Breaches` object: Top 10 largest breaches
    - `Detailed_Breach_Info` object: Detailed information about each breach

## Other responses

- `401`: Unauthorized - Invalid or missing API key
- `500`: Internal Server Error - An error occurred during processing

---

[API](https://skmtc.dev/xposedornot/apis/xposedornot-api.md) - [All operations](https://skmtc.dev/xposedornot/apis/xposedornot-api/llms.txt) - [OpenAPI document](https://skmtc.dev/xposedornot/apis/xposedornot-api/revisions/d9fae920f998?raw)