Retrieve an evaluator

curl https://api.respan.ai/api/evaluators/evaluator_id/ \
     -H "Authorization: Bearer sk_live_xxxxx"

{
  "id": "0f4325f9-55ef-4c20-8abe-376694419947",
  "name": "Response Quality Evaluator",
  "evaluator_slug": "response_quality_v2",
  "type": "llm",
  "score_value_type": "numerical",
  "eval_class": "",
  "description": "Evaluates response quality on a 1-5 scale",
  "score_config": {
    "min_score": 1,
    "max_score": 5,
    "choices": [
      {
        "name": "Poor",
        "value": 1
      },
      {
        "name": "Fair",
        "value": 2
      },
      {
        "name": "Good",
        "value": 3
      },
      {
        "name": "Great",
        "value": 4
      },
      {
        "name": "Excellent",
        "value": 5
      }
    ]
  },
  "passing_conditions": {
    "primary_score": {
      "operator": "gte",
      "value": 3
    }
  },
  "llm_config": {
    "model": "gpt-4o-mini",
    "evaluator_definition": "Rate the quality:\n<input>{{input}}</input>\n<output>{{output}}</output>",
    "scoring_rubric": "1=Poor, 5=Excellent",
    "temperature": 0.1,
    "max_tokens": 200
  },
  "configurations": {},
  "created_by": {
    "first_name": "Respan",
    "last_name": "Team",
    "email": "admin@respan.ai"
  },
  "updated_by": {
    "first_name": "Respan",
    "last_name": "Team",
    "email": "admin@respan.ai"
  },
  "created_at": "2025-09-11T09:43:55.858321Z",
  "updated_at": "2025-09-11T09:43:55.858331Z",
  "custom_required_fields": [],
  "starred": false,
  "organization": 2,
  "tags": []
}

Retrieve an evaluator by ID, including its full configuration.

Path parameters

evaluator_idstringRequired

Evaluator Id

Response

Successful response for Retrieve evaluator

idstring

namestring

evaluator_slugstring

typestring

score_value_typestring

eval_classstring

descriptionstring

score_configobject

passing_conditionsobject

llm_configobject

code_configstring

configurationsobject

created_byobject

updated_byobject

created_atstring

updated_atstring

custom_required_fieldslist of strings

categorical_choiceslist of objects or null

starredboolean

organizationinteger

tagslist of strings

Errors

401

Unauthorized Error

Path parameters

Headers

Response

Errors