Related
Sips linked to source UUIDs through same_as or derived_from relationships
Follow related intelligence records
Returns sips linked to one or more source UUIDs through the requested relationship.
When to use: after searchEvents or searchSignals, call this endpoint to expand context around a known sip, deduplicate equivalent records, or trace derived intelligence.
Relationships: same_as returns equivalent or duplicate records. derived_from returns downstream records generated from, or based on, the supplied source sip IDs.
Input: ids is required and must contain one or more RFC 4122 UUID strings. The relationship path value must be exactly same_as or derived_from.
Response shape: each result is a flattened event or signal digest with id and reported added by the router. Additional pipeline-specific keys may appear.
Agent format: use response_type=text for compact field-per-line related records; use JSON when the caller needs structured parsing.
path Parameters
relationshipRelationship to traverse. same_as finds equivalent records; derived_from follows generated intelligence.
query Parameters
idsSource sip UUIDs (CSV). Example: b07049b5-54c0-50b0-a620-d3aea3f8a173
response_typeOutput format. json returns flattened digest objects; text returns compact plain-text records for LLM/MCP context.
limitPage size. Default 16, max 128.
offsetNumber of related records to skip. Default 0.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Follow related intelligence records › Responses
Related event/signal digests when response_type=json; plain-text related record blocks when response_type=text
Decision Table
| Variant | Matching Criteria |
|---|---|
| type = object | |
| type = object |
idSip UUID (RFC 4122).
reportedReported timestamp of the sip (maps from persisted created).
briefingConcise summary of the event.
event_typeCategory or classification of the event.
impact_levelAssessed impact severity.
future_outlookForward-looking assessment of likely developments.
actionsMicro actions or developments that compose the event.
cross_domain_impactsEffects spanning multiple domains or sectors.
companiesCompanies or organizations associated with the event.
productsProducts or commodities associated with the event.
macro_contextBroader macroeconomic or geopolitical context for the event.
peoplePeople mentioned or involved in the event.
regionsGeographic regions associated with the event.
tagsScalar tags for filtering and discovery.