The SigNoz Traces API lets you search and aggregate trace data programmatically.
Endpoint
POST https://{URL}/api/v5/query_range
Replace {URL} with your SigNoz instance URL (e.g., your-instance.signoz.cloud).
Authentication
Generate an API key using a Service Account. Pass it in your request header:
SIGNOZ-API-KEY: {YOUR_API_KEY}
Operations
- Search traces — filter traces by service, duration, error status, or any span attribute.
- Aggregate traces — compute metrics (count, avg, p99, etc.) over filtered trace data.
- Payload model — request and response schema reference.
If you need help with the steps in this topic, please reach out to us on SigNoz Community Slack.
If you are a SigNoz Cloud user, please use in product chat support located at the bottom right corner of your SigNoz instance or contact us at cloud-support@signoz.io.
