COMING SOON

OSINT Intelligence API

Every feature available in the Sentinel dashboard is available through the REST API. Query events, manage watchlists, configure alerts, and pull entity histories programmatically.

REST API

Standard REST endpoints with JSON responses. Fully documented with OpenAPI spec.

API Key Auth

Simple API key authentication. Rate limits based on your subscription tier.

Webhooks

Receive alerts via webhook POST to your endpoint. Custom payload templates.

SDKs

Official Python and TypeScript SDKs. Community libraries for Go, Rust, and Java.

Preview

Example API Responses

A preview of what the Sentinel API will return. These reflect the actual normalized event schema used in our data pipeline.

GET/api/v1/events

Query normalized intelligence events across all domains.

Response

{
  "data": [
    {
      "id": "evt_2026031800001",
      "source": "usgs",
      "category": "seismic",
      "event_type": "earthquake",
      "title": "M 5.8 - 42km SSW of Kahramanmaras, Turkey",
      "severity": "high",
      "coordinates": {
        "lat": 37.42,
        "lon": 36.58
      },
      "timestamp": "2026-03-18T14:23:07Z",
      "metadata": {
        "magnitude": 5.8,
        "depth_km": 12.4,
        "felt_reports": 847,
        "tsunami_warning": false
      },
      "content_hash": "sha256:a1b2c3d4..."
    },
    {
      "id": "evt_2026031800002",
      "source": "adsb_mil",
      "category": "aviation",
      "event_type": "military_track",
      "title": "USAF KC-135R tanker orbit pattern — Eastern Mediterranean",
      "severity": "medium",
      "coordinates": {
        "lat": 35.12,
        "lon": 33.45
      },
      "timestamp": "2026-03-18T14:25:31Z",
      "metadata": {
        "icao": "AE0441",
        "callsign": "DOOM71",
        "aircraft_type": "K35R",
        "altitude_ft": 28000,
        "speed_kts": 420,
        "heading": 270,
        "squawk": "6413"
      },
      "content_hash": "sha256:e5f6g7h8..."
    }
  ],
  "pagination": {
    "page": 1,
    "per_page": 50,
    "total": 12847,
    "has_more": true
  }
}

GET/api/v1/entities/:id/history

Retrieve position history for a tracked entity (aircraft, vessel, satellite).

Response

{
  "entity": {
    "id": "ent_ae0441",
    "type": "aircraft",
    "source": "adsb_mil",
    "identifiers": {
      "icao": "AE0441",
      "registration": "63-8871",
      "aircraft_type": "KC-135R Stratotanker"
    },
    "first_seen": "2026-03-17T08:12:00Z",
    "last_seen": "2026-03-18T14:25:31Z",
    "total_observations": 342
  },
  "history": [
    {
      "timestamp": "2026-03-18T14:25:31Z",
      "lat": 35.12,
      "lon": 33.45,
      "altitude_ft": 28000,
      "speed_kts": 420,
      "heading": 270
    },
    {
      "timestamp": "2026-03-18T14:24:16Z",
      "lat": 35.14,
      "lon": 33.52,
      "altitude_ft": 28000,
      "speed_kts": 418,
      "heading": 268
    }
  ]
}

POST/api/v1/watchlists

Create a watchlist with custom alert criteria.

Response

{
  "watchlist": {
    "id": "wl_00123",
    "name": "Eastern Mediterranean Military Activity",
    "filters": {
      "categories": ["aviation", "maritime"],
      "bounds": {
        "north": 40.0,
        "south": 30.0,
        "east": 40.0,
        "west": 25.0
      },
      "severity_min": "medium",
      "keywords": ["military", "tanker", "surveillance"]
    },
    "delivery": {
      "channels": ["slack", "email"],
      "throttle_minutes": 15,
      "digest_mode": false
    },
    "created_at": "2026-03-18T10:00:00Z",
    "status": "active"
  }
}

Get API access

API access is available on Analyst tier and above. Join the waitlist to be notified when the API goes live.