List evaluation runs
GET
/v1/evaluations/runsHow to call this endpoint
Every ACP API request uses bearer authentication. The examples here show the actual request path, auth header, and body shape that the platform expects.
Path, query, and header parameters
These parameters control which ACP object the endpoint acts on and how the request is processed.
Path parameters
None.
Query parameters
| Name | Location | Type | Required | Description |
|---|---|---|---|---|
| targetType | query | agent | function | metronome | service_topology | none | No | Filter by the immutable execution target kind. |
| targetId | query | string | No | Filter by the immutable execution target identifier. |
| targetVersionId | query | string | No | Filter by the exact pinned target version. |
| q | query | string | No | Case-insensitive run label or identifier search. |
| view | query | summary | No | Omit case output |
| evaluationId | query | string | No | — |
| agentId | query | string | No | — |
| status | query | string | No | — |
| limit | query | integer | No | — |
| offset | query | integer | No | — |
Body schema
This endpoint does not require a request body.
None.
What the API returns
Each response code below includes the documented payload shape for the ACP API.
200Accessible Evaluation runs in stable creation orderapplication/json
| Field | Type | Required | Description |
|---|---|---|---|
| object | list | Yes | — |
| data | object[] | Yes | — |
| data[].id | string | Yes | Unique identifier. |
| data[].checkpointCount | integer | No | Number of durably accepted cases; not a quality score. |
| data[].summaryView | boolean | No | True for compact run listings without case payloads or evidence. |
| data[].totalCount | integer | No | — |
| data[].scoredCount | integer | No | — |
| data[].passedCount | integer | No | — |
| data[].failedCount | integer | No | — |
| data[].errorCount | integer | No | — |
| data[].skippedCount | integer | No | — |
| data[].missingCount | integer | No | — |
| data[].evaluationId | string | No | — |
| data[].targetType | agent | function | metronome | service_topology | none | No | — |
| data[].targetId | string | No | — |
| data[].targetVersionId | string | No | — |
| data[].targetVersionNumber | integer | No | — |
| data[].targetInvocation | object | No | — |
| data[].targetInvocation.method | GET | POST | PUT | PATCH | DELETE | No | — |
| data[].targetInvocation.path | string | No | Workspace-relative file path. |
| data[].targetInvocation.timeoutMs | integer | No | — |
| data[].agentId | string | No | Agent ID. |
| data[].environmentId | string | No | Computer ID. |
| data[].versionId | string | No | — |
| data[].purpose | diagnostic | development | optimization | release | external_validation | No | — |
| data[].status | queued | running | completed | completed_with_errors | failed | cancelled | Yes | Current lifecycle status. |
| data[].averageScore | number | No | — |
| data[].passRate | number | No | — |
| data[].costUsd | number | No | — |
| data[].runFingerprint | string | No | — |
| data[].evidence | object | No | — |
| data[].evidence.schemaVersion | computer_agents_evaluation_run_evidence_v2 | Yes | — |
| data[].evidence.runId | string | Yes | — |
| data[].evidence.evaluation | object | Yes | — |
| data[].evidence.evaluation.id | string | Yes | Unique identifier. |
| data[].evidence.evaluation.versionId | string | Yes | — |
| data[].evidence.evaluation.versionNumber | integer | Yes | — |
| data[].evidence.evaluation.purpose | diagnostic | development | optimization | release | external_validation | Yes | — |
| data[].evidence.evaluation.evaluationFingerprint | string | Yes | — |
| data[].evidence.evaluation.datasetFingerprint | string | Yes | — |
| data[].evidence.target | object | Yes | — |
| data[].evidence.target.bindingStatus | control_plane_pinned | legacy_unverified | Yes | — |
| data[].evidence.target.agentId | string | Yes | Agent ID. |
| data[].evidence.target.agentVersionId | string | Yes | — |
| data[].evidence.target.agentVersionNumber | integer | Yes | — |
| data[].evidence.target.agentVersionStatus | string | Yes | — |
| data[].evidence.target.targetType | agent | function | metronome | service_topology | none | Yes | — |
| data[].evidence.target.targetId | string | Yes | — |
| data[].evidence.target.targetVersionId | string | Yes | — |
| data[].evidence.target.targetVersionNumber | integer | Yes | — |
| data[].evidence.target.targetFingerprint | string | Yes | — |
| data[].evidence.executionContext | object | Yes | — |
| data[].evidence.executionContext.environmentId | string | Yes | Computer ID. |
| data[].evidence.status | completed | completed_with_errors | failed | cancelled | Yes | Current lifecycle status. |
| data[].evidence.metrics | object | Yes | — |
| data[].evidence.metrics.totalCount | integer | Yes | — |
| data[].evidence.metrics.reportedCount | integer | Yes | — |
| data[].evidence.metrics.scoredCount | integer | Yes | — |
| data[].evidence.metrics.passedCount | integer | Yes | — |
| data[].evidence.metrics.failedCount | integer | Yes | — |
| data[].evidence.metrics.errorCount | integer | Yes | — |
| data[].evidence.metrics.skippedCount | integer | Yes | — |
| data[].evidence.metrics.missingCount | integer | Yes | — |
| data[].evidence.metrics.averageScore | number | Yes | — |
| data[].evidence.metrics.passRate | number | Yes | — |
| data[].evidence.cost | object | Yes | — |
| data[].evidence.cost.usd | number | Yes | — |
| data[].evidence.cost.legacyComputeTokens | number | Yes | — |
| data[].evidence.evaluator | object | Yes | — |
| data[].evidence.evaluator.evaluatorFingerprint | string | Yes | — |
| data[].evidence.evaluator.systemFingerprint | string | Yes | — |
| data[].evidence.generatedAt | string | Yes | — |
| data[].evidence.resultSetFingerprint | string | Yes | — |
| data[].evidence.reportFingerprint | string | Yes | — |
| data[].evidence.provenance | object | Yes | — |
| data[].evidence.provenance.schemaVersion | computer_agents_evaluation_run_evidence_provenance_v1 | Yes | — |
| data[].evidence.provenance.source | execution_worker | api_client | computer_agents_thread | legacy_import | Yes | — |
| data[].evidence.provenance.trustLevel | self_reported | verified_worker | Yes | — |
| data[].evidence.provenance.verificationStatus | unverified | verified | Yes | — |
| data[].evidence.provenance.executor | object | Yes | — |
| data[].evidence.provenance.executor.kind | string | Yes | — |
| data[].evidence.provenance.executor.id | string | Yes | Unique identifier. |
| data[].evidence.provenance.attestation | object | Yes | — |
| data[].evidence.provenance.attestation.schemaVersion | computer_agents_evaluation_execution_attestation_v1 | Yes | — |
| data[].evidence.provenance.attestation.attestationId | string | Yes | — |
| data[].evidence.provenance.attestation.workerId | string | Yes | — |
| data[].evidence.provenance.attestation.dispatchId | string | Yes | — |
| data[].evidence.provenance.attestation.workerAssertionId | string | Yes | — |
| data[].evidence.provenance.attestation.credentialId | string | Yes | — |
| data[].evidence.provenance.attestation.claimAttempt | integer | Yes | — |
| data[].evidence.provenance.attestation.runId | string | Yes | — |
| data[].evidence.provenance.attestation.evaluationId | string | Yes | — |
| data[].evidence.provenance.attestation.evaluationVersionId | string | Yes | — |
| data[].evidence.provenance.attestation.evaluationFingerprint | string | Yes | — |
| data[].evidence.provenance.attestation.datasetFingerprint | string | Yes | — |
| data[].evidence.provenance.attestation.targetType | agent | function | metronome | service_topology | none | Yes | — |
| data[].evidence.provenance.attestation.targetId | string | Yes | — |
| data[].evidence.provenance.attestation.targetVersionId | string | No | — |
| data[].evidence.provenance.attestation.targetAgentId | string | No | — |
| data[].evidence.provenance.attestation.targetAgentVersionId | string | No | — |
| data[].evidence.provenance.attestation.targetFingerprint | string | Yes | — |
| data[].evidence.provenance.attestation.environmentId | string | No | Computer ID. |
| data[].evidence.provenance.attestation.resultSetFingerprint | string | Yes | — |
| data[].evidence.provenance.attestation.reportFingerprint | string | Yes | — |
| data[].evidence.provenance.attestation.issuedAt | string | Yes | — |
| data[].evidence.provenance.attestation.verifiedAt | string | Yes | — |
| data[].evidence.results | object[] | Yes | — |
| data[].evidence.results[].caseId | string | Yes | — |
| data[].evidence.results[].name | string | No | Human-readable name. |
| data[].evidence.results[].status | passed | failed | error | skipped | Yes | Current lifecycle status. |
| data[].evidence.results[].score | number | No | — |
| data[].evidence.results[].output | object | No | — |
| data[].evidence.results[].explanation | string | No | — |
| data[].evidence.results[].error | string | No | — |
| data[].evidence.results[].durationMs | integer | No | — |
| data[].evidence.results[].evaluator | object | No | — |
| data[].evidence.results[].metadata | object | No | Free-form metadata object. |
| data[].evidence.fingerprint | string | Yes | — |
| data[].evidence.signature | object | No | — |
| data[].evidence.signature.schemaVersion | computer_agents_evaluation_evidence_signature_v1 | Yes | — |
| data[].evidence.signature.provider | google_cloud_kms | Yes | — |
| data[].evidence.signature.keyVersion | string | Yes | — |
| data[].evidence.signature.algorithm | string | Yes | — |
| data[].evidence.signature.signedFingerprint | string | Yes | — |
| data[].evidence.signature.signature | string | Yes | — |
| data[].evidence.signature.signedAt | string | Yes | — |
| data[].evidenceSchemaVersion | string | No | — |
| data[].evidenceFingerprintVerified | boolean | No | — |
| data[].evidenceSource | string | No | — |
| data[].evidenceTrustLevel | string | No | — |
| data[].evidenceVerificationStatus | string | No | — |
| data[].evidenceProvenanceVerified | boolean | No | — |
| data[].evidenceAttestationId | string | No | — |
| data[].evidenceSignatureStatus | unsigned | kms_signed | invalid | No | — |
| data[].evidenceSignatureKeyVersion | string | No | — |
| data[].evidenceSignatureAlgorithm | string | No | — |
| data[].createdAt | string | No | ISO 8601 timestamp. |
| data[].updatedAt | string | No | ISO 8601 timestamp. |
| data[].completedAt | string | No | ISO 8601 timestamp. |
| runs | object[] | Yes | — |
| runs[].id | string | Yes | Unique identifier. |
| runs[].checkpointCount | integer | No | Number of durably accepted cases; not a quality score. |
| runs[].summaryView | boolean | No | True for compact run listings without case payloads or evidence. |
| runs[].totalCount | integer | No | — |
| runs[].scoredCount | integer | No | — |
| runs[].passedCount | integer | No | — |
| runs[].failedCount | integer | No | — |
| runs[].errorCount | integer | No | — |
| runs[].skippedCount | integer | No | — |
| runs[].missingCount | integer | No | — |
| runs[].evaluationId | string | No | — |
| runs[].targetType | agent | function | metronome | service_topology | none | No | — |
| runs[].targetId | string | No | — |
| runs[].targetVersionId | string | No | — |
| runs[].targetVersionNumber | integer | No | — |
| runs[].targetInvocation | object | No | — |
| runs[].targetInvocation.method | GET | POST | PUT | PATCH | DELETE | No | — |
| runs[].targetInvocation.path | string | No | Workspace-relative file path. |
| runs[].targetInvocation.timeoutMs | integer | No | — |
| runs[].agentId | string | No | Agent ID. |
| runs[].environmentId | string | No | Computer ID. |
| runs[].versionId | string | No | — |
| runs[].purpose | diagnostic | development | optimization | release | external_validation | No | — |
| runs[].status | queued | running | completed | completed_with_errors | failed | cancelled | Yes | Current lifecycle status. |
| runs[].averageScore | number | No | — |
| runs[].passRate | number | No | — |
| runs[].costUsd | number | No | — |
| runs[].runFingerprint | string | No | — |
| runs[].evidence | object | No | — |
| runs[].evidence.schemaVersion | computer_agents_evaluation_run_evidence_v2 | Yes | — |
| runs[].evidence.runId | string | Yes | — |
| runs[].evidence.evaluation | object | Yes | — |
| runs[].evidence.evaluation.id | string | Yes | Unique identifier. |
| runs[].evidence.evaluation.versionId | string | Yes | — |
| runs[].evidence.evaluation.versionNumber | integer | Yes | — |
| runs[].evidence.evaluation.purpose | diagnostic | development | optimization | release | external_validation | Yes | — |
| runs[].evidence.evaluation.evaluationFingerprint | string | Yes | — |
| runs[].evidence.evaluation.datasetFingerprint | string | Yes | — |
| runs[].evidence.target | object | Yes | — |
| runs[].evidence.target.bindingStatus | control_plane_pinned | legacy_unverified | Yes | — |
| runs[].evidence.target.agentId | string | Yes | Agent ID. |
| runs[].evidence.target.agentVersionId | string | Yes | — |
| runs[].evidence.target.agentVersionNumber | integer | Yes | — |
| runs[].evidence.target.agentVersionStatus | string | Yes | — |
| runs[].evidence.target.targetType | agent | function | metronome | service_topology | none | Yes | — |
| runs[].evidence.target.targetId | string | Yes | — |
| runs[].evidence.target.targetVersionId | string | Yes | — |
| runs[].evidence.target.targetVersionNumber | integer | Yes | — |
| runs[].evidence.target.targetFingerprint | string | Yes | — |
| runs[].evidence.executionContext | object | Yes | — |
| runs[].evidence.executionContext.environmentId | string | Yes | Computer ID. |
| runs[].evidence.status | completed | completed_with_errors | failed | cancelled | Yes | Current lifecycle status. |
| runs[].evidence.metrics | object | Yes | — |
| runs[].evidence.metrics.totalCount | integer | Yes | — |
| runs[].evidence.metrics.reportedCount | integer | Yes | — |
| runs[].evidence.metrics.scoredCount | integer | Yes | — |
| runs[].evidence.metrics.passedCount | integer | Yes | — |
| runs[].evidence.metrics.failedCount | integer | Yes | — |
| runs[].evidence.metrics.errorCount | integer | Yes | — |
| runs[].evidence.metrics.skippedCount | integer | Yes | — |
| runs[].evidence.metrics.missingCount | integer | Yes | — |
| runs[].evidence.metrics.averageScore | number | Yes | — |
| runs[].evidence.metrics.passRate | number | Yes | — |
| runs[].evidence.cost | object | Yes | — |
| runs[].evidence.cost.usd | number | Yes | — |
| runs[].evidence.cost.legacyComputeTokens | number | Yes | — |
| runs[].evidence.evaluator | object | Yes | — |
| runs[].evidence.evaluator.evaluatorFingerprint | string | Yes | — |
| runs[].evidence.evaluator.systemFingerprint | string | Yes | — |
| runs[].evidence.generatedAt | string | Yes | — |
| runs[].evidence.resultSetFingerprint | string | Yes | — |
| runs[].evidence.reportFingerprint | string | Yes | — |
| runs[].evidence.provenance | object | Yes | — |
| runs[].evidence.provenance.schemaVersion | computer_agents_evaluation_run_evidence_provenance_v1 | Yes | — |
| runs[].evidence.provenance.source | execution_worker | api_client | computer_agents_thread | legacy_import | Yes | — |
| runs[].evidence.provenance.trustLevel | self_reported | verified_worker | Yes | — |
| runs[].evidence.provenance.verificationStatus | unverified | verified | Yes | — |
| runs[].evidence.provenance.executor | object | Yes | — |
| runs[].evidence.provenance.executor.kind | string | Yes | — |
| runs[].evidence.provenance.executor.id | string | Yes | Unique identifier. |
| runs[].evidence.provenance.attestation | object | Yes | — |
| runs[].evidence.provenance.attestation.schemaVersion | computer_agents_evaluation_execution_attestation_v1 | Yes | — |
| runs[].evidence.provenance.attestation.attestationId | string | Yes | — |
| runs[].evidence.provenance.attestation.workerId | string | Yes | — |
| runs[].evidence.provenance.attestation.dispatchId | string | Yes | — |
| runs[].evidence.provenance.attestation.workerAssertionId | string | Yes | — |
| runs[].evidence.provenance.attestation.credentialId | string | Yes | — |
| runs[].evidence.provenance.attestation.claimAttempt | integer | Yes | — |
| runs[].evidence.provenance.attestation.runId | string | Yes | — |
| runs[].evidence.provenance.attestation.evaluationId | string | Yes | — |
| runs[].evidence.provenance.attestation.evaluationVersionId | string | Yes | — |
| runs[].evidence.provenance.attestation.evaluationFingerprint | string | Yes | — |
| runs[].evidence.provenance.attestation.datasetFingerprint | string | Yes | — |
| runs[].evidence.provenance.attestation.targetType | agent | function | metronome | service_topology | none | Yes | — |
| runs[].evidence.provenance.attestation.targetId | string | Yes | — |
| runs[].evidence.provenance.attestation.targetVersionId | string | No | — |
| runs[].evidence.provenance.attestation.targetAgentId | string | No | — |
| runs[].evidence.provenance.attestation.targetAgentVersionId | string | No | — |
| runs[].evidence.provenance.attestation.targetFingerprint | string | Yes | — |
| runs[].evidence.provenance.attestation.environmentId | string | No | Computer ID. |
| runs[].evidence.provenance.attestation.resultSetFingerprint | string | Yes | — |
| runs[].evidence.provenance.attestation.reportFingerprint | string | Yes | — |
| runs[].evidence.provenance.attestation.issuedAt | string | Yes | — |
| runs[].evidence.provenance.attestation.verifiedAt | string | Yes | — |
| runs[].evidence.results | object[] | Yes | — |
| runs[].evidence.results[].caseId | string | Yes | — |
| runs[].evidence.results[].name | string | No | Human-readable name. |
| runs[].evidence.results[].status | passed | failed | error | skipped | Yes | Current lifecycle status. |
| runs[].evidence.results[].score | number | No | — |
| runs[].evidence.results[].output | object | No | — |
| runs[].evidence.results[].explanation | string | No | — |
| runs[].evidence.results[].error | string | No | — |
| runs[].evidence.results[].durationMs | integer | No | — |
| runs[].evidence.results[].evaluator | object | No | — |
| runs[].evidence.results[].metadata | object | No | Free-form metadata object. |
| runs[].evidence.fingerprint | string | Yes | — |
| runs[].evidence.signature | object | No | — |
| runs[].evidence.signature.schemaVersion | computer_agents_evaluation_evidence_signature_v1 | Yes | — |
| runs[].evidence.signature.provider | google_cloud_kms | Yes | — |
| runs[].evidence.signature.keyVersion | string | Yes | — |
| runs[].evidence.signature.algorithm | string | Yes | — |
| runs[].evidence.signature.signedFingerprint | string | Yes | — |
| runs[].evidence.signature.signature | string | Yes | — |
| runs[].evidence.signature.signedAt | string | Yes | — |
| runs[].evidenceSchemaVersion | string | No | — |
| runs[].evidenceFingerprintVerified | boolean | No | — |
| runs[].evidenceSource | string | No | — |
| runs[].evidenceTrustLevel | string | No | — |
| runs[].evidenceVerificationStatus | string | No | — |
| runs[].evidenceProvenanceVerified | boolean | No | — |
| runs[].evidenceAttestationId | string | No | — |
| runs[].evidenceSignatureStatus | unsigned | kms_signed | invalid | No | — |
| runs[].evidenceSignatureKeyVersion | string | No | — |
| runs[].evidenceSignatureAlgorithm | string | No | — |
| runs[].createdAt | string | No | ISO 8601 timestamp. |
| runs[].updatedAt | string | No | ISO 8601 timestamp. |
| runs[].completedAt | string | No | ISO 8601 timestamp. |
| hasMore | boolean | Yes | — |
| nextOffset | integer | Yes | — |