Get one eval

The eval.

GET /api/v1/evals/{id}

cURL

curl --request GET \
  --url 'https://response.stateset.com/api/v1/evals/{id}' \
  --header "Authorization: Bearer $RESPONSECX_API_KEY"

200

{
  "object": "eval",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Two-Person Tent",
  "type": "standard",
  "status": "pending",
  "description": "Two-person tent, green — replacement for damaged pole set.",
  "user_message": "string",
  "preferred_output": "string",
  "non_preferred_output": "string",
  "reason_type": "string",
  "customer_impact": "string",
  "response_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "ticket_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "created_at": "2026-08-31T14:22:05Z",
  "updated_at": "2026-08-31T14:22:05Z"
}

Path parameters

id · string (uuid) · required

The eval id.

Response

object

object · string · required

id · string (uuid) · required

name · string,null · required

From the stored eval_name.

type · string,null · required

Defaults to preference on create.

status · string,null · required

Defaults to pending on create.

description · string,null · required

user_message · string,null · required

The customer message to replay. Copied from the source response when response_id was supplied.

preferred_output · string,null · required

The reply the agent should have given.

non_preferred_output · string,null · required

The reply that was actually given. Copied from the source response when response_id was supplied.

reason_type · string,null · required

customer_impact · string,null · required

response_id · string,null (uuid) · required

agent_id · string,null (uuid) · required

ticket_id · string,null · required

Stored as a string; derived from the source response when not supplied.

created_at · string,null (date-time) · required

updated_at · string,null (date-time) · required

Status codes

Code	Meaning
200	The eval.
401	Missing, invalid, or expired API key.
403	The key lacks a required scope.
404	Not found, or not in the organization that owns the key.
429	Rate limit exceeded.

Access

Required scope	responses:read
Rate limit	120 requests per minute

cURL

curl --request GET \
  --url 'https://response.stateset.com/api/v1/evals/{id}' \
  --header "Authorization: Bearer $RESPONSECX_API_KEY"

200

{
  "object": "eval",
  "id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "Two-Person Tent",
  "type": "standard",
  "status": "pending",
  "description": "Two-person tent, green — replacement for damaged pole set.",
  "user_message": "string",
  "preferred_output": "string",
  "non_preferred_output": "string",
  "reason_type": "string",
  "customer_impact": "string",
  "response_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "agent_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "ticket_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "created_at": "2026-08-31T14:22:05Z",
  "updated_at": "2026-08-31T14:22:05Z"
}