curl --request GET \
--url https://api.promptlayer.com/api/public/v2/evaluations \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.promptlayer.com/api/public/v2/evaluations"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.promptlayer.com/api/public/v2/evaluations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.promptlayer.com/api/public/v2/evaluations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.promptlayer.com/api/public/v2/evaluations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.promptlayer.com/api/public/v2/evaluations")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.promptlayer.com/api/public/v2/evaluations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": "<string>",
"evaluations": [
{
"id": 123,
"name": "<string>",
"workspace_id": 123,
"comment": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"folder_id": 123,
"user_id": 123,
"dataset_id": 123,
"is_blueprint": true,
"tags": {},
"deleted": true,
"parent_report_id": 123,
"score_configuration": {},
"runs": [
{
"id": 123,
"name": "<string>",
"comment": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"workspace_id": 123,
"folder_id": 123,
"user_id": 123,
"dataset_id": 123,
"is_blueprint": true,
"tags": {},
"deleted": true,
"parent_report_id": 123,
"score_configuration": {},
"score": {},
"score_matrix": "<array>",
"score_calculation_error": "<string>",
"status": "RUNNING",
"stats": {
"status_counts": {}
}
}
],
"external_ids": [
{
"source": "<string>",
"external_id": "<string>"
}
]
}
],
"page": 123,
"per_page": 123,
"total": 123,
"pages": 123
}{
"success": false,
"message": "<string>",
"error": "<string>"
}{
"success": false,
"message": "<string>",
"error": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}List Evaluations
curl --request GET \
--url https://api.promptlayer.com/api/public/v2/evaluations \
--header 'X-API-KEY: <api-key>'import requests
url = "https://api.promptlayer.com/api/public/v2/evaluations"
headers = {"X-API-KEY": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {'X-API-KEY': '<api-key>'}};
fetch('https://api.promptlayer.com/api/public/v2/evaluations', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.promptlayer.com/api/public/v2/evaluations",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"X-API-KEY: <api-key>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.promptlayer.com/api/public/v2/evaluations"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-KEY", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.promptlayer.com/api/public/v2/evaluations")
.header("X-API-KEY", "<api-key>")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.promptlayer.com/api/public/v2/evaluations")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
request["X-API-KEY"] = '<api-key>'
response = http.request(request)
puts response.read_body{
"success": true,
"message": "<string>",
"evaluations": [
{
"id": 123,
"name": "<string>",
"workspace_id": 123,
"comment": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"folder_id": 123,
"user_id": 123,
"dataset_id": 123,
"is_blueprint": true,
"tags": {},
"deleted": true,
"parent_report_id": 123,
"score_configuration": {},
"runs": [
{
"id": 123,
"name": "<string>",
"comment": "<string>",
"created_at": "2023-11-07T05:31:56Z",
"updated_at": "2023-11-07T05:31:56Z",
"workspace_id": 123,
"folder_id": 123,
"user_id": 123,
"dataset_id": 123,
"is_blueprint": true,
"tags": {},
"deleted": true,
"parent_report_id": 123,
"score_configuration": {},
"score": {},
"score_matrix": "<array>",
"score_calculation_error": "<string>",
"status": "RUNNING",
"stats": {
"status_counts": {}
}
}
],
"external_ids": [
{
"source": "<string>",
"external_id": "<string>"
}
]
}
],
"page": 123,
"per_page": 123,
"total": 123,
"pages": 123
}{
"success": false,
"message": "<string>",
"error": "<string>"
}{
"success": false,
"message": "<string>",
"error": "<string>"
}{
"detail": [
{
"loc": [
"<string>"
],
"msg": "<string>",
"type": "<string>"
}
]
}Authorizations
Query Parameters
Filter by specific workspace ID. If not provided, uses the current user's workspace
x >= 1Filter evaluations by name (case-insensitive partial match)
Filter evaluations by status: 'active' (default) returns only active evaluations, 'deleted' returns only deleted/archived evaluations, 'all' returns both
active, deleted, all If true, include batch runs nested under each evaluation. Each run includes its full report data, status (RUNNING or COMPLETED), and cell status counts.
Page number for pagination
x >= 1Number of items per page
1 <= x <= 100Filter by the creator's email address.
Filter resources created at or after this timestamp.
Filter resources created at or before this timestamp.
Filter resources updated at or after this timestamp.
Filter resources updated at or before this timestamp.
External ID source to filter by. Must be provided with external_id.
External ID value to filter by. Must be provided with external_source.
Sort field.
created_at, updated_at, name, id Sort direction.
asc, desc Was this page helpful?

