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.

HTTP Header
Authorization: Bearer YOUR_API_KEY

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

GET /alerts

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

GET /endpoints

Returns a paginated list of all endpoints (devices) registered in your workspace, along with their current security status and OS version.

Example Request

Bash (cURL)
curl -X GET https://api.markocyber.com/v1/endpoints \
  -H "Authorization: Bearer YOUR_API_KEY"

Example Response

JSON
{
  "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

GET /threat-intel/iocs

Query our global threat intelligence network for Indicators of Compromise (IOCs). Search by IP address, domain, or file hash.

Webhooks

POST /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.

JSON Payload
{
  "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.

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.