> ## Documentation Index > Fetch the complete documentation index at: https://docs.labelbox.com/llms.txt > Use this file to discover all available pages before exploring further. # List evaluation runs > Returns evaluation runs newest first, including active runs and failed runs with no verdicts. Each run's target and verdict counts are read at one consistent point in time. ## OpenAPI ````yaml /managed-agents/openapi.yaml get /managed-agents/v1/evaluation-runs openapi: 3.1.0 info: title: Managed Agents API version: 0.13.0 description: >- The Recursion Managed Agents REST API. Authenticate with a Recursion API key as a bearer token. An organization-scoped key acts in its own organization and needs nothing else; a tenant-scoped key must also send `x-organization-id` with an organization id or `default`. Field names follow each operation's published schema. servers: - url: https://api.recursion.labelbox.com security: - bearerAuth: [] paths: /managed-agents/v1/evaluation-runs: get: tags: - Evaluations summary: List evaluation runs description: >- Returns evaluation runs newest first, including active runs and failed runs with no verdicts. Each run's target and verdict counts are read at one consistent point in time. operationId: managedAgentsListEvaluationRuns parameters: - description: Maximum runs to return. Defaults to 50. in: query name: limit schema: default: 50 description: Maximum runs to return. Defaults to 50. maximum: 100 minimum: 1 type: integer - description: >- Opaque signed continuation from next_page_token. It is bound to this organization and effective limit and expires after one hour. in: query name: page_token schema: description: >- Opaque signed continuation from next_page_token. It is bound to this organization and effective limit and expires after one hour. type: string responses: '200': content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsEvaluationRunListResponse' description: >- One page of organization-scoped evaluation-run summaries and an optional continuation. '400': description: The request was rejected by schema or semantic validation. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiError' '401': description: The caller is unauthenticated. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiError' '403': description: The caller lacks a required permission or capability. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiErrorForbidden' '429': headers: Retry-After: description: Seconds the caller should wait before retrying. schema: type: string style: simple description: A rate limit is exhausted. Honor `Retry-After`. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiError' '500': description: An unexpected server-side failure. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiError' '502': description: The service returned an invalid response. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiErrorBadGateway' '503': headers: Retry-After: description: Seconds the caller should wait before retrying. schema: type: string style: simple description: A dependency is unavailable. Retryable. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiError' '504': headers: Retry-After: description: When to retry, as delay seconds or an HTTP date. schema: type: string description: The service did not respond before the timeout. Retryable. content: application/json: schema: $ref: '#/components/schemas/ManagedAgentsApiErrorGatewayTimeout' components: schemas: ManagedAgentsEvaluationRunListResponse: additionalProperties: false description: >- One page of organization-scoped evaluation-run summaries and an optional continuation. properties: evaluation_runs: description: >- Newest-first platform-internal evaluation-run summaries for this page. items: $ref: '#/components/schemas/ManagedAgentsEvaluationRun' type: array next_page_token: description: >- Signed one-hour continuation bound to the organization and effective limit. type: string required: - evaluation_runs type: object example: evaluation_runs: - created_at: '2026-02-18T09:30:00.000Z' evaluator_agent_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d evaluator_agent_version_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d execution_state: provisioning fail_count: 1 not_applicable_count: 1 pass_count: 1 run_session_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d status: active targets_total: 1 updated_at: '2026-02-18T09:30:00.000Z' verdicts_total: 1 next_page_token: example ManagedAgentsApiError: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - analytics - analytics_not_ready - artifact_fetch_unavailable - artifact_generation_mismatch - artifact_hash_mismatch - artifact_invalid_events - artifact_invalid_json - artifact_not_allowlisted - artifact_size_mismatch - atomic_ingest_timeout - auth_unavailable - automation_event_source_invalid - automation_memory_unavailable - automation_reference_invalid - automation_runs_unconfigured - automations_unconfigured - bad_gateway - built_in_catalog_unavailable - built_in_integrations_unconfigured - compute_offerings_unavailable - conflict - content_store_request_canceled - content_store_unavailable - content_store_upload_timeout - credential_encryption_unconfigured - delegate_preparation_failed - entity_family_not_permitted - environment_not_verified - evaluation_cancellation_pending - evaluation_deletion_pending - event_admission_unavailable - event_ingress_unavailable - event_source_verification_credential_invalid - event_sources_unconfigured - execution_unconfigured - file_quota_exceeded - file_storage_unconfigured - forbidden - gateway_timeout - gestalt_unconfigured - github_rate_limited - github_unavailable - handoff_access_invalid - handoff_access_unavailable - handoff_access_unsupported - handoff_capture_unavailable - handoff_requires_retest - handoff_revoke_unavailable - handoff_signal_unavailable - idempotency_conflict - idempotency_in_progress - idempotency_unavailable - ingest_policy_changed - ingest_policy_not_found - ingest_policy_revoked - integrations_unconfigured - internal_error - invalid_json - invalid_pull_request_review_result - invalid_request - invalid_scope - invariant_violation - live_fleet_unconfigured - managed_agents_unavailable - missing_dependency - model_gateway_metadata_missing - model_gateway_unconfigured - model_gateway_unreachable - mutation_transaction_budget_exceeded - not_found - page_token_expired - payload_too_large - persistence_busy - precondition_failed - precondition_required - provider_registration_unsupported - provider_selection_unsupported - rate_limit_exceeded - rate_limited - repository_automation_unconfigured - request_too_large - reserved_source_type - revision_conflict - run_log_store_unavailable - runner_image_resolution_failed - sandbox_provider_disabled - service_unavailable - session_analyst_busy - session_analyst_model_unavailable - session_analyst_unconfigured - session_start_admission_unavailable - session_start_not_admitted - setup_fallback_environment_unsafe - setup_run_finished - setup_run_in_progress - setup_run_limit - setup_run_not_started - setup_runs_unavailable - skill_storage_unconfigured - slack_channels_rejected - slack_channels_unavailable - slack_channels_unconfigured - slack_connection_malformed - slack_event_intake_unavailable - slack_installation_mismatch - slack_missing_scope - slack_rate_limited - slack_reapproval_required - source_ownership_mismatch - source_revision_conflict - spanner_unavailable - streaming_unsupported - submission_transaction_budget_exceeded - task_version_number_conflict - team_board_unconfigured - too_many_streams - unauthorized - unsupported_media_type - vault_creation_retired - version_content_conflict - webhook_delivery_too_large - workspace_boundary_denied message: type: string minLength: 1 description: Human-readable error message. details: description: Optional structured error details. type: object propertyNames: type: string additionalProperties: {} required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorForbidden: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - forbidden message: type: string minLength: 1 description: Human-readable error message. details: description: Optional structured error details. type: object propertyNames: type: string additionalProperties: {} required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorBadGateway: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - bad_gateway message: type: string minLength: 1 description: Human-readable error message. details: description: Optional structured error details. type: object propertyNames: type: string additionalProperties: {} required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsApiErrorGatewayTimeout: type: object properties: code: type: string minLength: 1 description: Stable machine-readable error code. enum: - gateway_timeout message: type: string minLength: 1 description: Human-readable error message. details: description: Optional structured error details. type: object propertyNames: type: string additionalProperties: {} required: - code - message additionalProperties: false description: Standard flat error response. ManagedAgentsEvaluationRun: additionalProperties: false description: >- One evaluation-run summary with frozen target count and authoritative verdict totals. properties: created_at: description: UTC timestamp when the evaluation run was created. format: date-time type: string evaluator_agent_id: description: Evaluation agent selected for the run. format: uuid type: string evaluator_agent_version_id: description: Immutable evaluator version and rubric frozen by the run. format: uuid type: string execution_state: description: Current agent-loop state when available on the run session. enum: - provisioning - queued - running - idle - completed type: string fail_count: description: Number of immutable overall fail verdicts in the run. format: int64 minimum: 0 type: integer not_applicable_count: description: Number of immutable not-applicable verdicts in the run. format: int64 minimum: 0 type: integer pass_count: description: Number of immutable overall pass verdicts in the run. format: int64 minimum: 0 type: integer run_session_id: description: >- Root session that runs this evaluation. Read or stream it like any session. format: uuid type: string status: $ref: '#/components/schemas/ManagedAgentsSessionStatus' description: Coarse terminal or active session status for the run. targets_total: description: Number of target snapshots frozen into the run plan. format: int64 minimum: 0 type: integer updated_at: description: UTC timestamp of the latest run-session state change. format: date-time type: string verdicts_total: description: >- Total authoritative verdicts, equal to pass plus fail plus not applicable. format: int64 minimum: 0 type: integer required: - run_session_id - evaluator_agent_id - evaluator_agent_version_id - status - created_at - updated_at - targets_total - verdicts_total - pass_count - fail_count - not_applicable_count type: object example: created_at: '2026-02-18T09:30:00.000Z' evaluator_agent_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d evaluator_agent_version_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d execution_state: provisioning fail_count: 1 not_applicable_count: 1 pass_count: 1 run_session_id: 9f8b1c2d-3e4f-5a6b-7c8d-9e0f1a2b3c4d status: active targets_total: 1 updated_at: '2026-02-18T09:30:00.000Z' verdicts_total: 1 ManagedAgentsSessionStatus: description: Coarse session state shared by Managed Agents and imported RL rollouts. enum: - active - awaiting_human - completed - failed - cancelled type: string example: active securitySchemes: bearerAuth: type: http scheme: bearer description: A Recursion API key, created in the console under API keys. ````