Endpoints / list-events

List events

GET/api/v1/eventsdeveloperread

Paginated list of contract events ranked by award date, with the latest signal for each contract joined in. Alias of `/api/v1/contracts`.

Query parameters

Name	Type	Required	Description
engine	string	no	Engine name
ticker	string	no	Filter by ticker
agency	string	no	Filter by awarding agency
classification	string	no	NLP classification
from	string (date)	no	Award date ≥
to	string (date)	no	Award date ≤
limit	integer	no	1-200, default 50
offset	integer	no	pagination offset, default 0

Examples

curl -H "x-api-key: $INTELLIGENCE_API_KEY" \
  "https://intelligence-beryl.vercel.app/api/v1/events?engine=simple&ticker=LMT&limit=10"

Responses

200List of events with embedded latest signal

json

{
  "data": [
    {
      "contract": {
        "id": "CONT_AWD_N0001925C0070_9700_-NONE-_-NONE-",
        "ticker": "LMT",
        "recipient_name": "LOCKHEED MARTIN CORPORATION",
        "award_date": "2024-11-22",
        "contract_value": 3130421242,
        "awarding_agency": "Department of Defense",
        "nlp_classification": "Defense escalation",
        "match_confidence": 1
      },
      "signal": {
        "id": "8e728629-a546-436d-b483-a7dfb47f0c90",
        "contract_id": "CONT_AWD_N0001925C0070_9700_-NONE-_-NONE-",
        "engine_name": "simple",
        "engine_version": "0.1.0",
        "engine_tier": "simple",
        "signal_score": 67,
        "importance_score": 91,
        "confidence_score": 100,
        "risk_score": 21,
        "computed_at": "2026-05-12T13:56:18.123Z"
      }
    }
  ],
  "pagination": {
    "limit": 10,
    "offset": 0,
    "count": 1
  }
}