Method: projects.locations.agents.testCases.results.list

Fetches the list of run results for the given test case. A maximum of 100 results are kept for each test case.

HTTP request

GET https://{endpoint}/v3beta1/{parent=projects/*/locations/*/agents/*/testCases/*}/results

Where {endpoint} is one of the supported service endpoints.

The URLs use gRPC Transcoding syntax.

Path parameters



Required. The test case to list results for. Format: projects/<Project ID>/locations/<Location ID>/agents/<Agent ID>/ testCases/<TestCase ID>. Specify a - as a wildcard for TestCase ID to list results across multiple test cases.

Authorization requires the following IAM permission on the specified resource parent:

  • dialogflow.testcases.get

Query parameters



The maximum number of items to return in a single page. By default 100 and at most 1000.



The nextPageToken value returned from a previous list request.



The filter expression used to filter test case results. See API Filtering.

The expression is case insensitive. Only 'AND' is supported for logical operators. The supported syntax is listed below in detail:

[AND ] ... [AND latest]

The supported fields and operators are: field operator environment =, IN (Use value draft for draft environment) testTime >, <

latest only returns the latest test result in all results for each test case.

Examples: * "environment=draft AND latest" matches the latest test result for each test case in the draft environment. * "environment IN (e1,e2)" matches any test case results with an environment resource name of either "e1" or "e2". * "testTime > 1602540713" matches any test case results with test time later than a unix timestamp in seconds 1602540713.

Request body

The request body must be empty.

Response body

The response message for TestCases.ListTestCaseResults.

If successful, the response body contains data with the following structure:

JSON representation
  "testCaseResults": [
      object (TestCaseResult)
  "nextPageToken": string

object (TestCaseResult)

The list of test case results.



Token to retrieve the next page of results, or empty if there are no more results in the list.

Authorization scopes

Requires one of the following OAuth scopes:


For more information, see the Authentication Overview.