Skip to content
SignalPick Docs

API Reference

Authentication

All API requests require an API key in the header:

Terminal window
curl -H "Authorization: Bearer YOUR_API_KEY" \
  https://api.signalpick.com/v1/stats

Endpoints

GET /v1/stats

Get filtering statistics for your account.

{
  "total_spans_received": 1000000,
  "spans_forwarded": 200000,
  "spans_aggregated": 800000,
  "reduction_percentage": 80.0,
  "period": "24h"
}

GET /v1/patterns

List detected trace patterns.

{
  "patterns": [
    {
      "id": "pat_abc123",
      "operation": "POST /api/checkout",
      "count": 50000,
      "status": "aggregating",
      "exemplar_trace_id": "abc123def456"
    }
  ]
}

POST /v1/rules

Create a custom filtering rule.

Terminal window
curl -X POST https://api.signalpick.com/v1/rules \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Keep VIP customers",
    "condition": "attribute.customer_tier == \"vip\"",
    "action": "always_keep"
  }'