---
title: "Search span evaluations"
method: POST
path: "/v1/observability/spans/evaluations/search"
tags: ["beta.observability.spans"]
---

# Search span evaluations

`POST /v1/observability/spans/evaluations/search`

Search span evaluations

## Query parameters

- `from` string, date-time, nullable
- `to` string, date-time, nullable
- `page_size` integer
- `cursor` string, nullable

## Request body

- SpanEvaluationsRequest
  - `search_expression` string, nullable

## Response `200`

Successful Response

- GetSpanEvaluations
  - `span_evaluations` FeedResultGetSpanEvaluation, required
    - `results` GetSpanEvaluation[]
      - `customer_id` string, required
      - `organization_id` string, required
      - `workspace_id` string, required
      - `user_id` string, required
      - `trace_id` string, required
      - `span_id` string, required
      - `response_id` string, required
      - `conversation_id` string, required
      - `timestamp` string, date-time, required
      - `evaluation_name` string, required
      - `score_value` number, required
      - `score_label` string, required
      - `explanation` string, required
      - `metadata` object, required
    - `next` string, nullable
    - `cursor` string, nullable

## Other responses

- `400` — Bad Request - Invalid request parameters or data
- `404` — Not Found - Resource does not exist
- `408` — Request Timeout - Operation timed out
- `409` — Conflict - Resource conflict
- `422` — Unprocessable Entity - Validation error

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/933c4ebdcd72/schema)