curl -H "Authorization: Bearer sk_live_..." \
  -H "Accept: application/stix+json;version=2.1" \
  "https://socdefenders.ai/api/v1/iocs/stix?type=ipv4&since=2026-05-15T00:00:00Z&limit=500" \
  -o socdefenders.stix.json

{
  "type": "bundle",
  "id": "bundle--12345678-1234-1234-1234-123456789abc",
  "objects": [
    {
      "type": "identity",
      "spec_version": "2.1",
      "id": "identity--f8e75d96-8e4c-4b1a-9e3d-4f8a7b6c5d3e",
      "created": "2024-01-01T00:00:00.000Z",
      "modified": "2024-12-09T10:30:00.000Z",
      "name": "SOC Defenders",
      "identity_class": "organization"
    },
    {
      "type": "indicator",
      "spec_version": "2.1",
      "id": "indicator--87654321-4321-4321-4321-abc123456789",
      "created": "2024-12-08T14:30:00Z",
      "modified": "2024-12-09T08:15:00Z",
      "created_by_ref": "identity--f8e75d96-8e4c-4b1a-9e3d-4f8a7b6c5d3e",
      "object_marking_refs": [
        "marking-definition--bab4a63c-aed9-4cf5-a766-dfca5abac2bb"
      ],
      "name": "Malicious IPv4 Address - 192.168.1.1",
      "indicator_types": [
        "malicious-activity"
      ],
      "pattern": "[ipv4-addr:value = '192.168.1.1']",
      "pattern_type": "stix",
      "valid_from": "2024-12-08T14:30:00Z",
      "confidence": 85
    }
  ]
}

{
  "error": {
    "code": "missing_api_key",
    "message": "API key is required. Include it in the Authorization header as \"Bearer sk_live_...\"",
    "request_id": "req_abc123"
  }
}

{
  "error": {
    "code": "insufficient_scope",
    "message": "This endpoint requires the \"read:stix\" scope",
    "details": {
      "required_scope": "read:stix",
      "your_scopes": [
        "read:iocs"
      ],
      "upgrade_url": "https://socdefenders.ai/export#pricing"
    },
    "request_id": "req_abc123"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Please wait before making more requests.",
    "details": {
      "limit": 10,
      "reset_at": "2024-12-09T10:31:00Z",
      "tier": "free",
      "upgrade_url": "https://socdefenders.ai/export#pricing"
    },
    "request_id": "req_abc123"
  }
}

Export Formats

Export IOCs as a STIX 2.1 bundle

Generates a STIX 2.1 bundle of Indicator SDOs (Structured Data Objects) for direct download. Use this when you want a one-shot bundle; for streaming/polling integrations use the TAXII 2.1 endpoints instead.

Bundle structure

bundle
├── identity (SOC Defenders, optional)
├── marking-definition (TLP, optional)
└── indicator × N

Each indicator SDO carries:

A STIX 2.1 pattern (e.g. [ipv4-addr:value = '1.2.3.4'])
TLP marking (mapped from our confidence: high→green, medium→amber, low→clear, or override with tlp=)
Tags as STIX labels
MITRE references via kill_chain_phases

TLP markings

By default, indicators are tagged with TLP based on their confidence. Override with tlp=:

clear: share freely (low confidence)
green: share within community (high confidence indicators by default)
amber: limited distribution
amber+strict: amber + need-to-know
red: do not share

Splunk ES / Sentinel ingestion

Both platforms accept STIX bundles via their threat-intel connectors. Download with format=bundle (default) and upload via their UI/API.

Requires the Pro plan (read:stix scope).

GET

api

iocs

stix

curl -H "Authorization: Bearer sk_live_..." \
  -H "Accept: application/stix+json;version=2.1" \
  "https://socdefenders.ai/api/v1/iocs/stix?type=ipv4&since=2026-05-15T00:00:00Z&limit=500" \
  -o socdefenders.stix.json

{
  "type": "bundle",
  "id": "bundle--12345678-1234-1234-1234-123456789abc",
  "objects": [
    {
      "type": "identity",
      "spec_version": "2.1",
      "id": "identity--f8e75d96-8e4c-4b1a-9e3d-4f8a7b6c5d3e",
      "created": "2024-01-01T00:00:00.000Z",
      "modified": "2024-12-09T10:30:00.000Z",
      "name": "SOC Defenders",
      "identity_class": "organization"
    },
    {
      "type": "indicator",
      "spec_version": "2.1",
      "id": "indicator--87654321-4321-4321-4321-abc123456789",
      "created": "2024-12-08T14:30:00Z",
      "modified": "2024-12-09T08:15:00Z",
      "created_by_ref": "identity--f8e75d96-8e4c-4b1a-9e3d-4f8a7b6c5d3e",
      "object_marking_refs": [
        "marking-definition--bab4a63c-aed9-4cf5-a766-dfca5abac2bb"
      ],
      "name": "Malicious IPv4 Address - 192.168.1.1",
      "indicator_types": [
        "malicious-activity"
      ],
      "pattern": "[ipv4-addr:value = '192.168.1.1']",
      "pattern_type": "stix",
      "valid_from": "2024-12-08T14:30:00Z",
      "confidence": 85
    }
  ]
}

{
  "error": {
    "code": "missing_api_key",
    "message": "API key is required. Include it in the Authorization header as \"Bearer sk_live_...\"",
    "request_id": "req_abc123"
  }
}

{
  "error": {
    "code": "insufficient_scope",
    "message": "This endpoint requires the \"read:stix\" scope",
    "details": {
      "required_scope": "read:stix",
      "your_scopes": [
        "read:iocs"
      ],
      "upgrade_url": "https://socdefenders.ai/export#pricing"
    },
    "request_id": "req_abc123"
  }
}

{
  "error": {
    "code": "rate_limit_exceeded",
    "message": "Rate limit exceeded. Please wait before making more requests.",
    "details": {
      "limit": 10,
      "reset_at": "2024-12-09T10:31:00Z",
      "tier": "free",
      "upgrade_url": "https://socdefenders.ai/export#pricing"
    },
    "request_id": "req_abc123"
  }
}

Authorizations

X-API-Key

string

header

required

API key in X-API-Key header

Query Parameters

type

enum<string>

Filter by IOC type. Generates patterns specific to each: ipv4-addr:value, domain-name:value, url:value, file:hashes, etc.

Available options:

ipv4,

ipv6,

domain,

url,

md5,

sha1,

sha256,

sha512,

email,

cve,

mitre_attack

Example:

"ipv4"

since

string<date-time>

Lower time bound (ISO 8601). Clamped to tier lookback.

Example:

"2026-05-15T00:00:00Z"

limit

integer

default:100

Maximum number of indicator SDOs in the bundle. Capped at 1000 per request.

Required range: x <= 1000

Example:

500

format

enum<string>

default:bundle

bundle wraps objects in a STIX Bundle (recommended — most tools expect this). objects returns just the array, no wrapper.

Available options:

bundle,

objects

Example:

"bundle"

include_identity

boolean

default:true

Include a SOC Defenders Identity SDO that all indicators reference via created_by_ref. Most STIX consumers expect this; keep enabled unless your importer rejects unknown SDOs.

Example:

true

include_tlp_markings

boolean

default:false

Include explicit TLP Marking Definition SDOs. Some tools require these to recognize TLP tagging on indicators; others auto-resolve them. Toggle on if your importer drops indicators whose object_marking_refs is unresolved.

Example:

true

tlp

enum<string>

Force a TLP level on every indicator (overrides the confidence-based default).

Available options:

clear,

green,

amber,

amber+strict,

red

Example:

"amber"

Response

STIX 2.1 bundle with TLP markings

type

enum<string>

Available options:

bundle

string

Pattern: ^bundle--[0-9a-f-]+$

objects

object[]

Overview

IOC Endpoints

Articles Endpoints

TAXII 2.1

IOCs

Statistics

Export Formats

Detection Rules

Lookup

API Keys

TAXII

Articles

Export IOCs as a STIX 2.1 bundle

Bundle structure

TLP markings

Splunk ES / Sentinel ingestion

Authorizations

Query Parameters

Response