API

API Reference

Programmatic access to Secure Raven's compliance monitoring platform. Build integrations, automate workflows, and extend functionality with our REST API.

REST API

Built for developers

The Secure Raven API is a RESTful interface that gives you full programmatic access to every feature of the platform. Query findings, trigger missions, manage controls, and automate your entire compliance workflow.

Authenticate using API keys generated from your dashboard. All requests are made over HTTPS and responses are returned in JSON format.

Base URL: https://api.secureraven.com/v1
Authentication: Bearer token (API key)
Rate Limit: 1,000 requests/minute
Format: JSON request & response
Example Request
curl -X GET \
  "https://api.secureraven.com/v1/findings" \
  -H "Authorization: Bearer sr_live_..." \
  -H "Content-Type: application/json"
Response: 200 OKJSON
{
  "findings": [
    {
      "id": "fnd_7x9k2m",
      "severity": "high",
      "status": "open"
    }
  ],
  "total": 42
}
Endpoints

Explore the endpoints

Full CRUD operations across all platform resources with consistent, predictable patterns.

Systems

Manage connected systems and data sources. List, create, update, and remove infrastructure targets.

GET /v1/systems

Findings

Query and manage security findings. Filter by severity, status, framework, and time range.

GET /v1/findings

Controls

Access compliance controls and their current assessment status across all mapped frameworks.

GET /v1/controls

Missions

Create, schedule, and monitor agent missions. Retrieve mission results and execution history.

POST /v1/missions

Evidence

Collect, upload, and retrieve audit evidence. Attach evidence to controls for compliance reports.

GET /v1/evidence

Events

Stream real-time security events and audit logs. Subscribe to webhooks for automated workflows.

GET /v1/events
SDKs

SDKs & libraries

Official client libraries to accelerate your integration with idiomatic code.

TypeScript / Node.js

Full-featured SDK with TypeScript types, async iterators, and built-in retry logic.

$ npm install @secureraven/sdk
View documentation

Python

Pythonic SDK with async support, Pydantic models, and comprehensive error handling.

$ pip install secureraven
View documentation

Go

Coming Soon

Idiomatic Go client with context support, connection pooling, and generated types.

Coming Q2 2026

Get your API key and start building

Create a free account to generate API keys and access the full API documentation.

Get API KeyRead the Docs