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'
{
  "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.