Integrate breach intelligence into your applications with our RESTful API
Get started with the Juncture Incidents API in minutes.
Sign up for an account and generate your API key from the dashboard.
Include your API key in the Authorization header with every request.
Receive JSON responses with breach data, ready to integrate.
All API requests require authentication using an API key in the Authorization header.
curl -X GET "https://juncturelogic.com/incidents/api/search?q=healthcare" \
-H "Authorization: Bearer YOUR_API_KEY_HERE"⚠️ Security: Never expose your API key in client-side code or public repositories. Keep it secure and rotate regularly.
Search and filter security breaches with advanced query parameters.
| Parameter | Type | Description |
|---|---|---|
| q | string | Search query (company name, keywords) |
| state | string | Two-letter state code (e.g., CA, TX) |
| severity | string | Critical, High, Medium, or Low |
| from_date | date | Start date (YYYY-MM-DD) |
| to_date | date | End date (YYYY-MM-DD) |
| limit | integer | Results per page (max 100, default 50) |
| offset | integer | Pagination offset |
curl -X GET "https://juncturelogic.com/incidents/api/search?q=healthcare&state=CA&severity=Critical&limit=10" \
-H "Authorization: Bearer YOUR_API_KEY"{
"total": 284,
"count": 10,
"offset": 0,
"results": [
{
"id": 12345,
"name_of_covered_entity": "UCLA Health System",
"state": "CA",
"individuals_affected": 4500000,
"breach_submission_date": "2015-07-17",
"type_of_breach": "Hacking/IT Incident",
"location_of_breached_information": "Network Server",
"severity_score": 95,
"severity_level": "Critical",
"attack_vector": "External Hacking",
"affected_data_types": ["SSN", "Medical Records", "Financial Information"],
"narrative": "Major cyberattack compromising 4.5M patient records including SSN and financial data..."
}
]
}Get aggregate statistics about breaches in the database.
curl -X GET "https://juncturelogic.com/incidents/api/stats" \
-H "Authorization: Bearer YOUR_API_KEY"{
"total_breaches": 1803,
"total_individuals_affected": 222627456,
"average_breach_size": 123456,
"severity_distribution": {
"Critical": 542,
"High": 631,
"Medium": 458,
"Low": 172
},
"states_covered": 50,
"date_range": {
"earliest": "2009-09-25",
"latest": "2024-11-15"
}
}Retrieve detailed information about a specific breach.
curl -X GET "https://juncturelogic.com/incidents/api/breaches/12345" \
-H "Authorization: Bearer YOUR_API_KEY"Get comprehensive risk profile for a company based on breach history.
curl -X GET "https://juncturelogic.com/incidents/api/companies/Anthem/risk" \
-H "Authorization: Bearer YOUR_API_KEY"{
"company_name": "Anthem Inc.",
"total_breaches": 3,
"total_individuals_affected": 79500000,
"risk_score": 98,
"risk_level": "Critical",
"breach_frequency": "Low",
"average_severity": 94,
"most_common_vector": "External Hacking",
"recent_breaches": [
{
"date": "2015-02-04",
"affected": 78800000,
"severity": "Critical"
}
]
}| Code | Meaning | Description |
|---|---|---|
| 200 | OK | Request successful |
| 400 | Bad Request | Invalid parameters or malformed request |
| 401 | Unauthorized | Missing or invalid API key |
| 403 | Forbidden | API key lacks required permissions |
| 404 | Not Found | Resource does not exist |
| 429 | Too Many Requests | Rate limit exceeded |
| 500 | Internal Server Error | Server error, contact support |
Official client libraries to integrate quickly:
Our support team is here to assist with integration and questions.