Traces API

SigNoz Cloud - This page applies to SigNoz Cloud editions.
Self-Host - This page applies to self-hosted SigNoz editions.

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.

Is this page helpful

Last updatedMay 12, 2026

Edit on GitHub

Is this page helpful

On this page

Last updatedMay 12, 2026

Edit on GitHub