Skip to main content
GET
/
api
/
public
/
v2
/
evaluations
/
{evaluation_id}
/
rows
Get Evaluation Rows
curl --request GET \
  --url https://api.promptlayer.com/api/public/v2/evaluations/{evaluation_id}/rows \
  --header 'X-API-KEY: <api-key>'
{
  "success": true,
  "message": "success",
  "columns": [
    "input",
    "expected_output",
    "accuracy",
    "relevance"
  ],
  "rows": [
    [
      {
        "type": "dataset",
        "value": "What is PromptLayer?"
      },
      {
        "type": "dataset",
        "value": "A prompt management platform"
      },
      {
        "type": "eval",
        "status": "PASSED",
        "value": 0.95
      },
      {
        "type": "eval",
        "status": "PASSED",
        "value": 0.88
      }
    ]
  ],
  "page": 1,
  "per_page": 10,
  "pages": 3,
  "total": 25
}
Legacy Dataset, Evaluation, and Report endpoints are deprecated for new workflows. Use the Tables API for new dataset import, evaluation, scoring, recalculation, and reporting workflows.
Retrieve paginated evaluation rows with dataset input cells followed by evaluation result cells.

​
Behavior Notes

  • Each row is an array of cells matching the order of the columns array.
  • Dataset cells contain source row values; evaluation cells contain result status, value, and optional error details.

Authorizations

​
X-API-KEY
string
header
required

Path Parameters

​
evaluation_id
integer
required

The ID of the evaluation to retrieve rows from

Query Parameters

​
workspace_id
integer

Filter by specific workspace ID. Defaults to current user's workspace.

Required range: x >= 1
​
page
integer
default:1

Page number for pagination

Required range: x >= 1
​
per_page
integer
default:10

Number of rows per page (max 100)

Required range: 1 <= x <= 100

Response

Paginated evaluation rows.

​
success
enum<boolean>
required
Available options:
true
​
columns
string[]
required
​
page
integer
required
​
per_page
integer
required
​
pages
integer
required
​
total
integer
required
​
rows
((DatasetRowCell · object | EvaluationRowCell · object)[])[]
required

Rows containing dataset cells followed by evaluation result cells.

​
message
string