Search events

This endpoint retrieves events by transaction ID for events that occurred within the last 34 days. It is specifically designed for sampling-based testing workflows to detect revenue leakage. The Event Search API provides a critical observability tool that validates the integrity of your usage pipeline by allowing you to sample raw events and verify their matching against active billable metrics.

Why event observability matters for revenue leakage: Silent revenue loss occurs when events are dropped, delayed, or fail to match billable metrics due to:

• Upstream system failures
• Event format changes
• Misconfigured billable metrics

Use this endpoint to:

• Sample raw events and validate they match the expected billable metrics
• Build custom leakage detection alerts to prevent silent revenue loss
• Verify event processing accuracy during system changes or metric updates
• Debug event matching issues in real-time

Key response fields:

• Complete event details including transaction ID, customer ID, and properties
• Matched Metronome customer (if any)
• Matched billable metric information (if any)
• Processing status and duplicate detection flags

Usage guidelines:

⚠️ Important: This endpoint is heavily rate limited and designed for sampling workflows only. Do not use this endpoint to check every event in your system. Instead, implement a sampling strategy to randomly validate a subset of events for observability purposes.