Skip to main content
GET
/
agents
/
{agent_id}
/
evaluations
cURL
curl 'https://api.gumloop.com/api/v1/agents/AGENT_ID/evaluations?page_size=20' \
  -H 'Authorization: Bearer YOUR_ACCESS_TOKEN'
import requests

response = requests.get(
"https://api.gumloop.com/api/v1/agents/AGENT_ID/evaluations",
headers={"Authorization": "Bearer YOUR_ACCESS_TOKEN"},
params={"page_size": 20}
)
data = response.json()
for evaluation in data["evaluations"]:
print(evaluation["grade"], evaluation["data_results"])
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

fetch('https://api.gumloop.com/api/v1/agents/{agent_id}/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.gumloop.com/api/v1/agents/{agent_id}/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 => [
"Authorization: Bearer <token>"
],
]);

$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.gumloop.com/api/v1/agents/{agent_id}/evaluations"

req, _ := http.NewRequest("GET", url, nil)

req.Header.Add("Authorization", "Bearer <token>")

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.gumloop.com/api/v1/agents/{agent_id}/evaluations")
.header("Authorization", "Bearer <token>")
.asString();
require 'uri'
require 'net/http'

url = URI("https://api.gumloop.com/api/v1/agents/{agent_id}/evaluations")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'

response = http.request(request)
puts response.read_body
{
  "evaluations": [
    {
      "evaluation_id": "eval_abc123",
      "interaction_id": "int_xyz789",
      "agent_id": "agent_456",
      "created_ts": "2026-06-15T14:30:00+00:00",
      "status": "completed",
      "grade": "pass",
      "call_successful": "success",
      "sentiment": "positive",
      "summary": "User asked about pricing and the agent provided accurate tier information.",
      "criteria_results": [
        {
          "id": "crit_1",
          "name": "Accuracy",
          "type": "other",
          "priority": "needs_attention",
          "result": "success",
          "rationale": "All pricing information matched the current rate card."
        },
        {
          "id": "crit_2",
          "name": "Stayed on Topic",
          "type": "voice_tone",
          "priority": "needs_review",
          "result": "success",
          "rationale": "Agent focused exclusively on the pricing question."
        }
      ],
      "data_results": [
        {
          "id": "dp_1",
          "name": "Customer Intent",
          "data_type": "string",
          "value": "pricing inquiry"
        },
        {
          "id": "dp_2",
          "name": "Confidence Score",
          "data_type": "number",
          "value": 8.5
        }
      ],
      "applied_tags": [
        "PRICING_INQUIRY",
        "POSITIVE_FEEDBACK"
      ]
    }
  ],
  "next_cursor": "eyJjcmVhdGVkX3RzIjoiMjAyNi0wNi0xNVQxNDozMDowMCswMDowMCJ9"
}

Authorizations

Authorization
string
header
required

A personal API key or an OAuth 2.0 access token. Personal API keys also require the x-auth-key header with your user ID.

Path Parameters

agent_id
string
required

ID of the agent whose evaluations to list.

Query Parameters

page_size
integer
default:20

Number of evaluations to return per page (1-100).

Required range: 1 <= x <= 100
cursor
string

Pagination cursor from a previous response's next_cursor field.

grade
enum<string>

Filter evaluations by grade.

Available options:
pass,
needs_review,
needs_attention

Response

Paginated list of evaluation results.

evaluations
object[]
next_cursor
string | null

Pass this value as the cursor query parameter to fetch the next page. Null when there are no more results.