Skip to content

List evaluation results

GET
/api/v2/evaluations
curl --request GET \
--url 'https://localhost:10001/api/v2/evaluations?since=2026-01-15T09%3A30%3A00Z&until=2026-01-15T09%3A30%3A00Z' \
--header 'Authorization: <Authorization>'

Retrieve a paginated list of evaluation results with optional filters

applicationId
integer

Filter by application ID

indicatorId
string

Filter by indicator UUID

projectId
integer

Filter by project ID

appliedPolicyId
string

Filter by applied policy ID, slug:my-policy, or urn:cid:bafy…

appliedPolicyControlId
integer

Filter by applied policy control ID

result
string

Filter by result status (pass, fail, error, awaiting_evaluation)

since
string

Filter evaluations after this timestamp, RFC 3339

until
string

Filter evaluations before this timestamp, RFC 3339

limit
integer

Number of results to return (default: 50, max: 200)

offset
integer

Number of results to skip (default: 0)

Paginated evaluation results

Media type application/json

A page of evaluation results, with the total available for pagination

object
limit
integer
offset
integer
results
Array<object>

One indicator evaluation, including its criteria outcomes and any declaration it produced

object
applicationId
integer
createdAt
string format: date-time
criterionResults
Array<object>

One criterion’s outcome within an evaluation; the evaluation passes only when every criterion does

object
criteriaIndex
integer
field
string
reason
string
status
string
Allowed values: pass fail skipped
declarationIds
Array<integer>
durationMs

Evaluation wall time in milliseconds

integer
evaluatedAt
string format: date-time
extractedFields
object
failureDetails
Array<object>

The machine-readable reason a criterion failed, including the values compared

object
actualValue
arrayMatchMode
string
Allowed values: all any
criteriaIndex
integer
criteriaType
string
Allowed values: string number boolean date list[string] list[number]
elementPath
string
expectedValue
extractionPath
string
field
string
indexPath
Array<integer>
missing
boolean
operator
string
Allowed values: eq neq gt lt gte lte in notIn contains notContains
reason
string
failureReasons
Array<string>
id

Urn:uuid form

string
indicatorId

Urn:uuid form

string
result
string
Allowed values: pass fail error awaiting_evaluation
triggerSource
string
total
integer
Example
{
"results": [
{
"criterionResults": [
{
"status": "pass"
}
],
"failureDetails": [
{
"arrayMatchMode": "all",
"criteriaType": "string",
"operator": "eq"
}
],
"result": "pass"
}
]
}

Bad request - Invalid filter parameter

Media type application/json

Error body returned by the governance endpoints; the message is human-readable and not a stable identifier

object
error
string
Example
{
"error": "Invalid request body"
}

Unauthorized - Authentication required

Media type application/json

Error body returned by the governance endpoints; the message is human-readable and not a stable identifier

object
error
string
Example
{
"error": "Invalid request body"
}

Forbidden - Insufficient permissions

Media type application/json

Error body returned by the governance endpoints; the message is human-readable and not a stable identifier

object
error
string
Example
{
"error": "Invalid request body"
}

Internal server error

Media type application/json

Error body returned by the governance endpoints; the message is human-readable and not a stable identifier

object
error
string
Example
{
"error": "Invalid request body"
}