NUKD.ac

API Documentation

The NUKD REST API provides programmatic access to our breach intelligence network with a friendly developer experience, rate limits, and webhooks.

Authentication

All requests require a Business-tier API key in the X-API-Key header.

curl https://api.nukd.ac/v1/breachedaccount/foo@bar.com \
  -H "X-API-Key: nukd_live_xxx"

Rate Limits

  • Free: not available via API
  • Pro: not available via API
  • Business: 60 requests/minute per key, unlimited daily total

Endpoints

GET /v1/breachedaccount/{email}

Returns the list of breaches an email appears in.

GET /v1/breaches

Returns the full breach catalogue.

POST /v1/monitor

Add an email to your monitored list.

Error Codes

  • 401 — Missing or invalid API key
  • 403 — Plan does not include API access
  • 429 — Rate limit exceeded
  • 5xx — Upstream data source error

Code Examples

JavaScript

const res = await fetch("https://api.nukd.ac/v1/breachedaccount/foo@bar.com", {
  headers: { "X-API-Key": process.env.NUKD_API_KEY }
});
const { breaches } = await res.json();

Python

import requests
r = requests.get(
  "https://api.nukd.ac/v1/breachedaccount/foo@bar.com",
  headers={"X-API-Key": NUKD_API_KEY},
)
print(r.json())

Powered by NUKD's breach intelligence network.