Discovery
Exact filter-value discovery for entities, regions, and event types
Discover exact Event entity filters
Use only when an agent needs available company or people names before applying an exact Event filter. Returned values are normalized snake_case filter strings, not canonical entity IDs or profiles.
If a known normalized value is already available, query Events directly. Use types=company or types=people to reduce the returned vocabulary.
query Parameters
qCase-insensitive substring filter.
typesEntity types (CSV): company, people.
response_typeResponse serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.
limitMaximum records per page. Default 20, max 100.
cursorOpaque continuation token. Send pagination.next_cursor from a previous response unchanged as cursor; never construct or decode it.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Discover exact Event entity filters › Responses
Entity value collection envelope
Collection pagination. Send next_cursor unchanged as the next request cursor. The response does not include a cursor echo field.
Discover exact Event region filters
Use only when an agent needs available region values before applying the exact regions Event filter. Returned values are normalized snake_case filter strings, not canonical places, coordinates, or structured geography.
If a known normalized value is already available, query Events directly.
query Parameters
qCase-insensitive substring filter.
response_typeResponse serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.
limitMaximum records per page. Default 20, max 100.
cursorOpaque continuation token. Send pagination.next_cursor from a previous response unchanged as cursor; never construct or decode it.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Discover exact Event region filters › Responses
Region value collection envelope
Collection pagination. Send next_cursor unchanged as the next request cursor. The response does not include a cursor echo field.
Discover exact Event type filters
Use only when an agent needs available values before applying the exact event_types Event filter. Returned values are normalized snake_case filter strings.
event_types and categories filter different Event fields. If a known normalized value is already available, query Events directly.
query Parameters
qCase-insensitive substring filter.
response_typeResponse serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.
limitMaximum records per page. Default 20, max 100.
cursorOpaque continuation token. Send pagination.next_cursor from a previous response unchanged as cursor; never construct or decode it.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Discover exact Event type filters › Responses
Event type value collection envelope
Collection pagination. Send next_cursor unchanged as the next request cursor. The response does not include a cursor echo field.
Discover fuzzy tag filters
Use only when an agent needs vocabulary for a fuzzy tags query. Returns persisted labels for Event and Signal filtering; tags are not a fixed taxonomy or exact-only values.
If a useful tag is already known, search Events or Signals directly instead of making a discovery request. Use resource to limit discovery to Event or Signal labels.
query Parameters
qCase-insensitive substring or prefix match.
resourceOptional resource scope (CSV): event, signal.
response_typeResponse serialization: JSON is canonical; YAML and TOON are token-optimized for MCP and AI-agent clients.
limitMaximum records per page. Default 20, max 100.
cursorOpaque continuation token. Send pagination.next_cursor from a previous response unchanged as cursor; never construct or decode it.
Headers
AuthorizationThe Authorization header is used to authenticate with the API using your API key. Value is of the format Bearer YOUR_KEY_HERE.
Discover fuzzy tag filters › Responses
Tag value collection envelope
Collection pagination. Send next_cursor unchanged as the next request cursor. The response does not include a cursor echo field.