Quick Reference
Quick Reference
A quick reference for all DarkSight Intel Partner API endpoints.
Base URL
https://platform.omegablack.io/api/v1
Authentication
All requests require:
Authorization: Bearer YOUR_TOKEN
Reports
| Method | Endpoint | Description |
|---|---|---|
| GET | /reports | List security reports |
| GET | /reports/{id} | Get report details |
Query Parameters:
page- Page number (default: 1)limit- Items per page (default: 20, max: 100)type- Filter by report typestatus- Filter: draft, published, archived
Signals
| Method | Endpoint | Description |
|---|---|---|
| GET | /signals | List threat signals |
Query Parameters:
type- Filter by signal typelimit- Items per page (default: 100, max: 1000)offset- Skip items
Credentials
| Method | Endpoint | Description |
|---|---|---|
| GET | /credentials | List compromised credentials |
Query Parameters:
credentialsPerGroup- Max per domain group (default: 10, max: 100)
Cyber Attacks
| Method | Endpoint | Description |
|---|---|---|
| GET | /cyber-attacks | List cyber attacks |
| GET | /cyber-attacks/{id} | Get attack details |
Query Parameters:
limit- Items per page (default: 20)offset- Skip itemsattack_type- Filter: ransomware, phishing, etc.threat_actor- Filter by threat actor name
Brand Intelligence
| Method | Endpoint | Description |
|---|---|---|
| POST | /brand-intelligence | Analyze domain for typosquatting |
| GET | /brand-intelligence/{domain} | Get cached analysis |
Request Body (POST):
{
"domain": "example.com"
}
Fraud Intelligence
| Method | Endpoint | Description |
|---|---|---|
| GET | /fraud-intelligence/overview | Fraud statistics overview |
| GET | /fraud-intelligence/cards | Compromised payment cards |
| GET | /fraud-intelligence/accounts | Compromised accounts |
Query Parameters (cards):
cardType- Filter: visa, mastercard, etc.bankName- Filter by issuing bankseverity- Filter: critical, high, medium, low
CVE Intelligence
| Method | Endpoint | Description |
|---|---|---|
| GET | /cve-intelligence/vulnerabilities | List CVEs |
| GET | /cve-intelligence/vulnerabilities/{id} | Get CVE details |
| GET | /cve-intelligence/trending | Trending CVEs |
Query Parameters:
severity- Filter: critical, high, medium, lowvendor- Filter by vendor namecveId- Filter by CVE ID (e.g., CVE-2025-1234)search- Search in title/description
Search
| Method | Endpoint | Description |
|---|---|---|
| GET | /search | Cross-collection search |
Query Parameters:
q(required) - Search query (min 2 chars)types- Comma-separated: reports, signals, credentials, attacks, cveslimit- Results per type (default: 10, max: 50)
Alerts
| Method | Endpoint | Description |
|---|---|---|
| GET | /alerts | List alerts |
| GET | /alerts/count | Unread alert count |
| GET | /alerts/{alertId} | Get alert details |
| PATCH | /alerts/{alertId}/acknowledge | Acknowledge alert |
| PATCH | /alerts/{alertId}/resolve | Resolve alert |
| PATCH | /alerts/{alertId}/dismiss | Dismiss alert |
Query Parameters (list):
status- Filter: new, acknowledged, resolved, dismissedseverity- Filter: critical, high, medium, low, infolimit- Items per page (default: 50, max: 100)offset- Skip items
Common Response Codes
| Code | Description |
|---|---|
| 200 | Success |
| 400 | Bad request - invalid parameters |
| 401 | Unauthorized - invalid/missing token |
| 403 | Forbidden - insufficient permissions |
| 404 | Not found |
| 429 | Rate limit exceeded |
| 500 | Server error |
Pagination
Most list endpoints support pagination:
{
"data": [...],
"pagination": {
"page": 1,
"limit": 20,
"total": 150,
"pages": 8
}
}
Updated 4 days ago
