Skip to main content
GET
/
v1
/
scores
/
{scoreId}
Get Score
curl --request GET \
  --url https://api.agentmark.co/v1/scores/{scoreId} \
  --header 'Authorization: <api-key>' \
  --header 'X-Agentmark-App-Id: <x-agentmark-app-id>'
{
  "id": "550e8400-e29b-41d4-a716-446655440000",
  "resource_id": "span_abc123",
  "name": "quality",
  "score": 0.95,
  "label": "high_quality",
  "reason": "Response addresses all user requirements clearly.",
  "source": "eval",
  "user_id": null,
  "created_at": "2026-04-10T15:30:45.123Z"
}

Authorizations

​
Authorization
string
header
required

Your AgentMark API key. Create one in the dashboard under Settings > API Keys.

Example: Authorization: Bearer am_live_abc123

Headers

​
X-Agentmark-App-Id
string
required

Your application ID. Found in the dashboard under Settings > General.

Example:

"app_abc123"

Path Parameters

​
scoreId
string<uuid>
required

The score ID to retrieve.

Response

The score record.

​
id
string<uuid>
Example:

"550e8400-e29b-41d4-a716-446655440000"

​
resource_id
string
Example:

"span_abc123"

​
name
string
Example:

"quality"

​
score
number
Example:

0.95

​
label
string
Example:

"high_quality"

​
reason
string
Example:

"Response addresses all user requirements clearly."

​
source
string

How the score was created (e.g., eval, manual).

Example:

"eval"

​
user_id
string | null

The user who created the score, if applicable.

​
created_at
string<date-time>
Example:

"2026-04-10T15:30:45.123Z"