{"openapi":"3.1.0","info":{"title":"BenchLM Radar Event API","version":"1.0.0","description":"A read-only, source-linked intelligence feed for autonomous agents and applications."},"servers":[{"url":"https://radar.benchlm.ai"}],"paths":{"/v1/events":{"get":{"operationId":"listRadarEvents","summary":"List Radar events and poll for new events","security":[{"radarApiKey":[]}],"parameters":[{"name":"limit","in":"query","schema":{"type":"integer","minimum":1,"maximum":200,"default":50}},{"name":"cursor","in":"query","description":"Opaque nextCursor from a prior response. Results are returned oldest-first while polling.","schema":{"type":"string"}},{"name":"provider","in":"query","schema":{"type":"string"}},{"name":"type","in":"query","description":"Exact event type, or outage for the complete outage lifecycle.","schema":{"type":"string"}},{"name":"after","in":"query","deprecated":true,"description":"ISO timestamp. Prefer cursor so events sharing a timestamp cannot be skipped.","schema":{"type":"string","format":"date-time"}}],"responses":{"200":{"description":"A page of source-linked Radar events.","headers":{"X-RateLimit-Limit":{"schema":{"type":"integer"}},"X-RateLimit-Remaining":{"schema":{"type":"integer"}},"X-RateLimit-Reset":{"schema":{"type":"string","format":"date-time"}}},"content":{"application/json":{"schema":{"type":"object","required":["data","nextCursor","hasMore","usage"],"properties":{"data":{"type":"array","items":{"$ref":"#/components/schemas/Event"}},"nextCursor":{"type":["string","null"]},"hasMore":{"type":"boolean"},"usage":{"type":"object","properties":{"requests":{"type":"integer"},"limit":{"type":"integer"},"period":{"type":"string"}}}}}}}},"400":{"description":"Invalid filter or cursor."},"401":{"description":"Missing or invalid API key."},"403":{"description":"The API key no longer has Pro access."},"429":{"description":"Monthly API request limit reached."}}}}},"components":{"securitySchemes":{"radarApiKey":{"type":"http","scheme":"bearer","bearerFormat":"radar_live_…"}},"schemas":{"Event":{"type":"object","required":["id","providerSlug","eventType","title","evidenceState","confirmationState","firstObservedAt","sourceUrl"],"properties":{"id":{"type":"string"},"providerSlug":{"type":"string"},"eventType":{"type":"string"},"subjectType":{"type":["string","null"]},"subjectKey":{"type":["string","null"]},"title":{"type":"string"},"summary":{"type":["string","null"]},"sourceUrl":{"type":"string","format":"uri"},"canonicalUrl":{"type":["string","null"],"format":"uri"},"evidenceState":{"type":"string"},"confirmationState":{"type":"string","enum":["confirmed","unconfirmed"]},"firstObservedAt":{"type":"string","format":"date-time"},"sourcePublishedAt":{"type":["string","null"],"format":"date-time"},"sourceUpdatedAt":{"type":["string","null"],"format":"date-time"},"detectedVia":{"type":["string","null"]},"correctedAt":{"type":["string","null"],"format":"date-time"},"retractedAt":{"type":["string","null"],"format":"date-time"}}}}}}