# Orq.ai Traces API

**Canonical:** https://apis.io/apis/orq/orq-traces-api/  
**Provider:** Orq.ai — https://apis.io/providers/orq/  
**Base URL:** https://my.orq.ai  
**Documentation:** https://docs.orq.ai/reference

Orq.ai Traces API is one of 59 APIs that [Orq.ai](https://apis.io/providers/orq/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Traces. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

Query and inspect ingested trace data: search trace summaries, aggregate metrics, and read individual traces and their spans.

## Operations (10)

| Method | Path | Summary |
|---|---|---|
| POST | `/v3/traces/aggregate` | Aggregate traces |
| GET | `/v3/traces/facets` | List trace facets |
| GET | `/v3/traces/facets/{field}` | List trace facet values |
| GET | `/v3/traces/fields` | List trace fields |
| POST | `/v3/traces/query` | Query traces with OQL |
| POST | `/v3/traces/search` | Search traces |
| GET | `/v3/traces/{trace_id}` | Get trace |
| GET | `/v3/traces/{trace_id}/spans` | List trace spans |
| GET | `/v3/traces/{trace_id}/spans/{span_id}` | Get trace span |
| GET | `/v3/traces/{trace_id}/conversation` | Get trace conversation |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/orq/openapi/orq-traces-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/orq/json-schema/orq-invoke-deployment-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/orq/json-schema/orq-search-knowledge-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/orq/json-schema/orq-response-stream-event-schema.json
- **JSONSchema** — https://artifacts.apis.io/orq/json-schema/orq-agent-thought-streaming-event-schema.json
- **JSONSchema** — https://artifacts.apis.io/orq/json-schema/orq-agent-started-streaming-event-schema.json
- **JSONSchema** — https://artifacts.apis.io/orq/json-schema/orq-model-metadata-schema.json

## Other Orq.ai APIs (12)

- [Orq.ai Agent Feedback API](https://apis.io/apis/orq/orq-agent-feedback-api/)
- [Orq.ai Agent Schedules API](https://apis.io/apis/orq/orq-agent-schedules-api/)
- [Orq.ai Agents API](https://apis.io/apis/orq/orq-agents-api/)
- [Orq.ai Alerts API](https://apis.io/apis/orq/orq-alerts-api/)
- [Orq.ai Annotation Queues API](https://apis.io/apis/orq/orq-annotation-queues-api/)
- [Orq.ai Annotations API](https://apis.io/apis/orq/orq-annotations-api/)
- [Orq.ai API keys API](https://apis.io/apis/orq/orq-api-keys-api/)
- [Orq.ai Audio API](https://apis.io/apis/orq/orq-audio-api/)
- [Orq.ai Audit Logs API](https://apis.io/apis/orq/orq-audit-logs-api/)
- [Orq.ai Budgets API](https://apis.io/apis/orq/orq-budgets-api/)
- [Orq.ai Chunking API](https://apis.io/apis/orq/orq-chunking-api/)
- [Orq.ai Classify API](https://apis.io/apis/orq/orq-classify-api/)

## Tags

Traces

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/orq/orq-traces-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/orq/.