Implementation:Openai Openai python Eval List Params

Knowledge Sources	Openai_Openai_python OpenAI API Reference
Domains	API_Types, Python
Last Updated	2026-02-15 00:00 GMT

Overview

Concrete type for evaluation listing query parameters provided by the openai-python SDK.

Description

The EvalListParams TypedDict defines optional query parameters for paginating and sorting evaluations via client.evals.list(). It supports after (a cursor ID from the previous page), limit (number of evals to retrieve), order ("asc" or "desc" by timestamp), and order_by ("created_at" or "updated_at") to control the sort field.

Usage

Import this type when constructing or type-hinting pagination and sort parameters for evaluation listing requests.

Code Reference

Source Location

• Repository: openai-python
• File: src/openai/types/eval_list_params.py

Signature

class EvalListParams(TypedDict, total=False):
    after: str
    limit: int
    order: Literal["asc", "desc"]
    order_by: Literal["created_at", "updated_at"]

Import

from openai.types import EvalListParams

I/O Contract

Fields

Name	Type	Required	Description
after	str	No	Cursor ID from the previous pagination request
limit	int	No	Number of evals to retrieve
order	Literal["asc", "desc"]	No	Sort direction by timestamp
order_by	Literal["created_at", "updated_at"]	No	Field to sort by: creation time or last update time

Usage Examples

from openai import OpenAI

client = OpenAI()

# List evals sorted by most recently updated
evals = client.evals.list(
    limit=10,
    order="desc",
    order_by="updated_at",
)
for eval_obj in evals:
    print(f"{eval_obj.id}: {eval_obj.name}")

Related Pages

• Environment:Openai_Openai_python_Python_3_9_Plus