Skip to main content
API · Runs GET /api/v1/runs/{runUuid}/items Requires the GV.APIReader application role, or a higher role (Owner > Contributor > Reader). Operation ID · list_run_items

​
Request example

​
Authentication and access

  • Required role: GV.APIReader
  • Data classification: metadata
  • Side effects: none
Use an authentication scheme declared below. Ordinary workloads use application tokens; signed-in users use delegated tokens and Organization membership. Activation and invitation acceptance require a person, and execution callbacks require their registered identity.
  • Microsoft Entra delegated user token
  • Microsoft Entra application token

​
Parameters

​
runUuid

path Required Opaque Run UUID. string (uuid) Opaque Run UUID.

​
limit

query integer
  • Default: 50
minimum: 1 · maximum: 100

​
cursor

query Opaque continuation cursor. Reuse it only with the same parent, filters, and direction that issued it. string | null Opaque continuation cursor. Reuse it only with the same parent, filters, and direction that issued it. Any of Option 1: string string maximum length: 2048 Option 2: null null

​
validationTestUuid

query string (uuid) | null Any of Option 1: string (uuid) string (uuid) Option 2: null null

​
overallStatus

query string | null Any of Option 1: string string
  • Allowed values: "pending","running","pass","fail","no_results","error"
Option 2: null null

​
direction

query string
  • Allowed values: "asc","desc"
  • Default: "asc"

​
Responses

This guide summarizes response status codes and headers. Retrieve the deployed, authenticated OpenAPI document for the exact response body schemas and examples. The API also provides an authenticated Swagger UI; opening it in a browser does not automatically attach a bearer token. Error responses use application/problem+json. The response’s stable code and type map to the error-code reference.

​
200

Current page of validation Run Items.

​
Headers

  • Retry-After: Wait five seconds before polling again. Present only while the Run or Run Item is active. integerAllowed values5

​
401

A valid Microsoft Entra bearer token is required.

​
403

The authenticated principal does not have the required role.

​
404

The resource does not exist in this tenant.

​
409

The operation conflicts with current resource or Azure state.

​
422

The request is syntactically valid but semantically invalid.

​
429

The bounded application request rate was exceeded.

​
Headers

  • Retry-After: Seconds to wait before retrying. integerminimum: 1

​
503

A required dependency is temporarily unavailable.

​
Headers

  • Retry-After: Seconds to wait before retrying. integerminimum: 1