Skip to main content

Welcome

The Danger API flags up suspicious transactions by building and analysing a customer's digital footprint in real-time. You can learn more about Danger on the main website.

You'll find all the information you need here on how to work with the Danger API.

New here?

Need something specific?

⏱️ 2 minute quick start

Very short on time? Make your first request in 2 minutes by following these steps. Make sure you have an API key first.

Make a HTTP POST request, sending your API key as the HTTP basic authentication username (password can be blank), with a JSON content type and payload. Send only your own email for this first check:

curl 'https://app.usedanger.com/api/v1/check' \
-H 'Content-Type: application/json' \
-u '{API_KEY}:' \
--data '{ "email": "{YOUR_EMAIL}" }'

You should get back a 200 status response with your first check result:

{
"risk": {
"score": 0,
"risks": []
},
"email": {
"success": true,
"valid": true,
"normalized": "[email protected]",
"local_part": "dan",
"domain": {
"name": "example.com",
"tld": "com",
"registrar": "MarkMonitor, Inc.",
"created": "1995-08-13T04:00:00",
"expires": "2024-08-12T04:00:00",
"age": 10359
},
"digits_count": 0,
"name_match": true,
"free": true,
"disposable": false,
"private": false,
"registered": {
"apple": true,
"disney": false,
"spotify": false,
...
"total_count": 20,
"success_count": 16,
"success_ratio": 0.8,
"found_count": 4,
"found_ratio": 0.25
},
"breaches": [
"CafePress",
"PDL",
"Lastfm",
...
]
}
}

🥳 That's your first check done. To learn more, you can skip straight to the making a request section of the getting started guide to try a more detailed check.