Introduction
The MarkoCyber REST API allows you to programmatically manage endpoints, query threat intelligence, and automate your security workflows. It is organized around REST principles, has predictable resource-oriented URLs, and returns JSON-encoded responses.
Authentication
Authenticate your API requests by including your secret API key in the HTTP headers. You can generate an API key from your dashboard settings.
Warning: Never share your API key in publicly accessible areas such as GitHub, client-side code, or browser URLs.
Rate Limits
The API is rate-limited to protect against abuse. The default limit is 100 requests per minute per API key.
If you exceed the limit, the API will return a 429 Too Many Requests status code. Check the X-RateLimit-Reset header to see when your limit resets.
Alerts Endpoint
Retrieve a list of security alerts generated by the MarkoCyber platform. You can filter by severity (critical, high, medium, low) and status (open, resolved).
Endpoints API
Returns a paginated list of all endpoints (devices) registered in your workspace, along with their current security status and OS version.
Example Request
-H "Authorization: Bearer YOUR_API_KEY"
Example Response
"data": [
{
"id": "ep_7f8a9b2c",
"hostname": "macbook-pro-finance",
"status": "protected",
"last_seen": "2026-11-17T10:22:00Z"
}
],
"meta": { "total": 142, "page": 1 }
}
Threat Intel API
Query our global threat intelligence network for Indicators of Compromise (IOCs). Search by IP address, domain, or file hash.
Webhooks
Subscribe to real-time events such as threat.detected or endpoint.quarantined. We will send a POST request to your specified URL when the event occurs.
"event": "threat.detected",
"severity": "critical",
"endpoint_id": "ep_7f8a9b2c",
"threat_name": "Trojan.Emotet"
}
Error Codes
The API uses conventional HTTP response codes to indicate the success or failure of an API request.
200 OK- Everything worked as expected.400 Bad Request- The request was unacceptable, often due to missing a required parameter.401 Unauthorized- No valid API key provided.403 Forbidden- The API key doesn't have permissions to perform the request.429 Too Many Requests- Too many requests hit the API too quickly.
Pagination
All top-level API resources have support for bulk fetches via "list" API methods. These list API methods share a common structure, taking at least these two parameters: limit and page.
Official SDKs
We provide official libraries to speed up your development process.
- Python (pip install markocyber)
- Node.js (npm install @markocyber/sdk)
- Go (go get github.com/markocyber/go-sdk)