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

MethodEndpointDescription
GET/reportsList 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 type
  • status - Filter: draft, published, archived

Signals

MethodEndpointDescription
GET/signalsList threat signals

Query Parameters:

  • type - Filter by signal type
  • limit - Items per page (default: 100, max: 1000)
  • offset - Skip items

Credentials

MethodEndpointDescription
GET/credentialsList compromised credentials

Query Parameters:

  • credentialsPerGroup - Max per domain group (default: 10, max: 100)

Cyber Attacks

MethodEndpointDescription
GET/cyber-attacksList cyber attacks
GET/cyber-attacks/{id}Get attack details

Query Parameters:

  • limit - Items per page (default: 20)
  • offset - Skip items
  • attack_type - Filter: ransomware, phishing, etc.
  • threat_actor - Filter by threat actor name

Brand Intelligence

MethodEndpointDescription
POST/brand-intelligenceAnalyze domain for typosquatting
GET/brand-intelligence/{domain}Get cached analysis

Request Body (POST):

{
  "domain": "example.com"
}

Fraud Intelligence

MethodEndpointDescription
GET/fraud-intelligence/overviewFraud statistics overview
GET/fraud-intelligence/cardsCompromised payment cards
GET/fraud-intelligence/accountsCompromised accounts

Query Parameters (cards):

  • cardType - Filter: visa, mastercard, etc.
  • bankName - Filter by issuing bank
  • severity - Filter: critical, high, medium, low

CVE Intelligence

MethodEndpointDescription
GET/cve-intelligence/vulnerabilitiesList CVEs
GET/cve-intelligence/vulnerabilities/{id}Get CVE details
GET/cve-intelligence/trendingTrending CVEs

Query Parameters:

  • severity - Filter: critical, high, medium, low
  • vendor - Filter by vendor name
  • cveId - Filter by CVE ID (e.g., CVE-2025-1234)
  • search - Search in title/description

Search

MethodEndpointDescription
GET/searchCross-collection search

Query Parameters:

  • q (required) - Search query (min 2 chars)
  • types - Comma-separated: reports, signals, credentials, attacks, cves
  • limit - Results per type (default: 10, max: 50)

Alerts

MethodEndpointDescription
GET/alertsList alerts
GET/alerts/countUnread alert count
GET/alerts/{alertId}Get alert details
PATCH/alerts/{alertId}/acknowledgeAcknowledge alert
PATCH/alerts/{alertId}/resolveResolve alert
PATCH/alerts/{alertId}/dismissDismiss alert

Query Parameters (list):

  • status - Filter: new, acknowledged, resolved, dismissed
  • severity - Filter: critical, high, medium, low, info
  • limit - Items per page (default: 50, max: 100)
  • offset - Skip items

Common Response Codes

CodeDescription
200Success
400Bad request - invalid parameters
401Unauthorized - invalid/missing token
403Forbidden - insufficient permissions
404Not found
429Rate limit exceeded
500Server error

Pagination

Most list endpoints support pagination:

{
  "data": [...],
  "pagination": {
    "page": 1,
    "limit": 20,
    "total": 150,
    "pages": 8
  }
}