Documentation/TAXII 2.1

TAXII 2.1

The Threat Landscape TAXII server is a read-only Collections Server. Both the Intelligence API and IOC API are served from the same TAXII root, so a TIP or SIEM can sync structured STIX 2.1 without custom parsing.

Base URL: https://api.threatlandscape.io/taxii2

Authentication

TAXII accepts the same API key as REST. The standard TAXII format is HTTP Basic, with the key in the password field:

-H "Authorization: Basic $(echo -n ':YOUR_THREATLANDSCAPE_API_KEY' | base64)"

Bearer and apikey headers also work.

Required Accept header

Every request must include the TAXII 2.1 media type:

-H "Accept: application/taxii+json;version=2.1"

Discover collections

Discovery is unauthenticated. Collection access requires a key.

# Discovery
curl 'https://api.threatlandscape.io/taxii2/' \
  -H "Accept: application/taxii+json;version=2.1"

# Collections
curl 'https://api.threatlandscape.io/taxii2/api1/collections/' \
  -H "Accept: application/taxii+json;version=2.1" \
  -H "Authorization: Bearer YOUR_THREATLANDSCAPE_API_KEY"

Collections

CollectionID
Threat Landscape Intelligence Feed91aae408-a1e4-4b3a-84b4-de6f7f6c52e6
Threat Landscape IOC Feed4c3b2a1d-5e6f-4a8b-8c0d-e1f2a3b4c5d6

Quickstart

# Intelligence feed, first page
curl 'https://api.threatlandscape.io/taxii2/api1/collections/91aae408-a1e4-4b3a-84b4-de6f7f6c52e6/objects/?limit=20' \
  -H "Accept: application/taxii+json;version=2.1" \
  -H "Authorization: Bearer YOUR_THREATLANDSCAPE_API_KEY"

# IOC feed, first page
curl 'https://api.threatlandscape.io/taxii2/api1/collections/4c3b2a1d-5e6f-4a8b-8c0d-e1f2a3b4c5d6/objects/?limit=100' \
  -H "Accept: application/taxii+json;version=2.1" \
  -H "Authorization: Bearer YOUR_THREATLANDSCAPE_API_KEY"

Incremental polling

Use added_after to request objects ingested after a timestamp. The response includesX-TAXII-Date-Added-Last, which you can use as the next added_after value.

curl 'https://api.threatlandscape.io/taxii2/api1/collections/91aae408-a1e4-4b3a-84b4-de6f7f6c52e6/objects/?added_after=2026-05-01T00:00:00Z&limit=100' \
  -H "Accept: application/taxii+json;version=2.1" \
  -H "Authorization: Bearer YOUR_THREATLANDSCAPE_API_KEY"

For multi-page results, pass the opaque next token back as ?next=.... Do not construct or modify the token yourself.

Filter by STIX type

# Indicators only
curl 'https://api.threatlandscape.io/taxii2/api1/collections/91aae408-a1e4-4b3a-84b4-de6f7f6c52e6/objects/?match[type]=indicator' \
  -H "Accept: application/taxii+json;version=2.1" \
  -H "Authorization: Bearer YOUR_THREATLANDSCAPE_API_KEY"

# Threat actors and malware
curl 'https://api.threatlandscape.io/taxii2/api1/collections/91aae408-a1e4-4b3a-84b4-de6f7f6c52e6/objects/?match[type]=threat-actor,malware' \
  -H "Accept: application/taxii+json;version=2.1" \
  -H "Authorization: Bearer YOUR_THREATLANDSCAPE_API_KEY"

Errors

StatusMeaning
401Missing or invalid API key.
404Unknown collection or endpoint.
406Missing or incorrect Accept header.
429Rate limit exceeded. Retry after the Retry-After interval.

Full reference

Read the complete TAXII 2.1 reference on GitHub →

Related guides