For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
DiscordPlatform
DocumentationIntegrationsAPI referenceSDKsChangelog
DocumentationIntegrationsAPI referenceSDKsChangelog
  • API Reference
      • POSTCreate a score
      • GETList scores
      • GETRetrieve a score
      • PATCHUpdate a score
      • DELDelete a score
      • POSTCreate or update a log score
      • GETList log scores
      • GETRetrieve a log score
      • PATCHUpdate a log score
      • DELDelete a log score
      • POSTFilter scores
      • PUTReplace a score
      • PUTReplace a log score
  • Reference
    • Filters API Reference
LogoLogo
DiscordPlatform
API ReferenceScores

Retrieve a score

GET
https://api.respan.ai/api/scores/:id/
GET
/api/scores/:id/
$curl https://api.respan.ai/api/scores/id/ \
>     -H "Authorization: Bearer sk_live_4f3b2a1c9d8e7f6a5b4c3d2e" \
>     -H "Content-Type: application/json"
1{
2  "id": "score_550e8400",
3  "created_at": "2024-01-15T09:30:00Z",
4  "type": "llm",
5  "environment": "production",
6  "numerical_value": 4.5,
7  "string_value": "Good response quality",
8  "boolean_value": true,
9  "categorical_value": [
10    "excellent"
11  ],
12  "json_value": "{\"rating\": 5, \"reason\": \"Accurate\"}",
13  "is_passed": true,
14  "cost": 0.02,
15  "evaluator_id": "evl_550e8400",
16  "evaluator_slug": "response_quality",
17  "evaluator_name": "Response Quality",
18  "scorer": "marcus@example.com",
19  "log_id": "log_abc123",
20  "prompt_id": "prompt_789xyz",
21  "prompt_version_number": 3,
22  "dataset_id": "dataset_456def",
23  "automation_id": "auto_123abc",
24  "status": "completed",
25  "error_message": null,
26  "inputs": {
27    "input": {
28      "text": "What is the capital of France?"
29    },
30    "output": {
31      "text": "The capital of France is Paris."
32    },
33    "metrics": {},
34    "metadata": {}
35  },
36  "evaluator": {
37    "name": "Response Quality Evaluator",
38    "version": "1.2.0"
39  }
40}
Retrieve a score by score ID.
Was this page helpful?
Previous

Update a score

Next
Built with

Path parameters

idstringRequired

Score ID returned as id in score responses.

Headers

AuthorizationstringRequired

Bearer token. Use Bearer YOUR_API_KEY for API key auth or Bearer <JWT> for dashboard auth.

Response

Score details.
idstring
Score ID.
created_atdatetime
When the score was created.
typeenum
Evaluator execution type. Legacy rows may contain legacy type values.
environmentstring
Environment associated with the score.
numerical_valuedouble or null

Numeric score value. Use for numerical and percentage evaluators.

string_valuestring or null

Text score value. Use for text and legacy comment evaluators.

boolean_valueboolean or null

Boolean score value. Use for boolean evaluators.

categorical_valuelist of strings or null

Categorical score values. Use for single_select, multi_select, and legacy categorical evaluators.

json_valuestring or null

JSON score value encoded as a string. Use for json evaluators.

is_passedboolean or null
Whether the score passes the evaluator conditions.
costdouble or null
Evaluation cost in USD, when available.
evaluator_idstring or null
Evaluator ID associated with the score.
evaluator_slugstring or null
Evaluator slug associated with the score.
evaluator_namestring or null

Human-readable evaluator name, when available.

scorerstring or null

Who or what produced the score. For log-scoped score writes, the backend derives this from the authenticated user.

log_idstring or null

Associated log/span ID.

prompt_idstring or null
Associated prompt ID, when available.
prompt_version_numberinteger or null
Associated prompt version number, when available.
dataset_idstring or null
Associated dataset ID, when available.
automation_idstring or null
Associated automation ID, when available.
statusstring or null
Evaluation status, when available.
error_messagestring or null
Evaluation error message, when available.
inputsobject
Unified evaluator inputs stored with the score, when available.
evaluatorobject or null
Evaluator metadata when the score is associated with a platform evaluator.

Errors

401
Unauthorized Error
404
Not Found Error