Get an eval

GEThttps:/api.openai.com/v1/evals/{eval_id}

Get an evaluation by ID.

Path parameters

  • eval_id
    string
    Required
    The ID of the evaluation to retrieve.

Response

The Eval object matching the specified ID.

Example request
1
curl https://api.openai.com/v1/evals/eval_67abd54d9b0081909a86353f6fb9317a \
2
-H "Authorization: Bearer $OPENAI_API_KEY" \
3
-H "Content-Type: application/json"
Example response
1
{
2
"object": "eval",
3
"id": "eval_67abd54d9b0081909a86353f6fb9317a",
4
"data_source_config": {
5
"type": "custom",
6
"schema": {
7
"type": "object",
8
"properties": {
9
"item": {
10
"type": "object",
11
"properties": {
12
"input": {
13
"type": "string"
14
},
15
"ground_truth": {
16
"type": "string"
17
}
18
},
19
"required": [
20
"input",
21
"ground_truth"
22
]
23
}
24
},
25
"required": [
26
"item"
27
]
28
}
29
},
30
"testing_criteria": [
31
{
32
"name": "String check",
33
"id": "String check-2eaf2d8d-d649-4335-8148-9535a7ca73c2",
34
"type": "string_check",
35
"input": "{{item.input}}",
36
"reference": "{{item.ground_truth}}",
37
"operation": "eq"
38
}
39
],
40
"name": "External Data Eval",
41
"created_at": 1739314509,
42
"metadata": {},
43
}
Built with