Rate Limits
Allowance and pagination
Each tenant has a monthly API-call allowance and per-request result limit. Use limit, since, and cached successful responses. A 429 means the monthly allowance is exhausted or the request is too aggressive.
Developer API
TrapLayer customer APIs are tenant-scoped, tier-gated, and designed for SIEM, SOAR, reporting, and defensive enrichment workflows.
Reference Data Notice
All API payloads, indicators, IP addresses, timestamps, actor references, and SIEM examples shown on this page are fictional documentation examples. They are provided only to describe response structure and integration behavior, and must not be treated as live TrapLayer intelligence, customer telemetry, threat attribution, or evidence of activity by any real system or person.
Authentication
API keys are managed from the customer portal and inherit the tenant subscription, data tier, API-call allowance, and feed limits.
Authorization: Bearer tl_live_or_test_customer_key
X-TrapLayer-API-Key: tl_live_or_test_customer_key
Use one key per integration, keep keys server-side, rotate keys after staff or vendor changes, and cache responses according to indicator TTL.
| Endpoint | Purpose | Tier |
|---|---|---|
GET /api/customer/intel.json | Customer-safe event indicators with risk, confidence, source, TTL, and recommended action. | Yellow 1+ |
GET /api/customer/iocs.json | Source IP IOC feed for block, challenge, enrichment, and hunting workflows. | Yellow 1+ |
GET /api/customer/payloads.json | Payload hashes, families, delivery vectors, and related indicators without raw payload bodies. | Yellow 2+ |
GET /api/customer/analytics.json | Campaign, actor-hypothesis, behavior, MITRE/CVE, and executive-summary analytics. | Yellow 3+ |
GET /api/customer/reports/latest.pdf | Latest customer brief or executive report as a protected PDF download. | Plan-gated |
CEF and STIX-style variants are available at matching .cef and .stix.json endpoints when enabled for the tenant.
This sample uses reserved documentation values and synthetic intelligence fields.
{
"generated_at": "2026-10-05T21:10:00Z",
"example_data": true,
"notice": "Synthetic documentation sample. Not live intelligence.",
"data_contract": {"tier": "yellow_2", "label": "Yellow 2 SOC intelligence"},
"indicators": [
{
"indicator_id": "demo-indicator-0001",
"type": "source_ip",
"value": "203.0.113.24",
"classification": "ssh_login_failed",
"source": "synthetic-demo:ssh",
"observed_at": "2026-10-05T21:05:12Z",
"risk_score": 82,
"confidence_score": 94,
"ttl_hours": 168,
"recommended_action": "block_or_challenge"
}
]
}
Rate Limits
Each tenant has a monthly API-call allowance and per-request result limit. Use limit, since, and cached successful responses. A 429 means the monthly allowance is exhausted or the request is too aggressive.
Freshness
Customer-facing panels and API payloads should be treated as actionable only when the source, generated timestamp, confidence, and stale/cache warnings are acceptable for your workflow.
The commands and field names below demonstrate integration shape only. Output examples should be generated from your tenant feed after authentication.
# Splunk
curl -s -H "Authorization: Bearer $TRAPLAYER_API_KEY" \
"https://traplayer.com/api/customer/intel.json?limit=250" \
| jq -c '.indicators[]'
# Microsoft Sentinel custom table fields
IndicatorValue_s, Classification_s, RiskScore_d, ConfidenceScore_d,
RecommendedAction_s, Source_s, ObservedAt_t, TtlHours_d
401 | Missing, invalid, inactive, or revoked API key. |
402 | Billing status does not currently allow intelligence access. |
403 | The tenant data tier does not include the requested feed. |
429 | API-call allowance or rate limit exceeded. |
5xx | TrapLayer service or collector path error. Retry with backoff and use cached data if available. |
The current customer API is v1-compatible and additive by default. New fields may appear without breaking existing keys. Breaking changes require a published migration window and customer notice.