> ## Documentation Index > Fetch the complete documentation index at: https://docs.threetone.in/llms.txt > Use this file to discover all available pages before exploring further. # List Test Invocations > Lists all test invocations with pagination support and optional search filtering. ## OpenAPI ````yaml /api-reference/openapi.json get /v1/convai/test-invocations openapi: 3.1.0 info: title: Threetone API Documentation description: >- This is the documentation for the Threetone API. You can use this API to use our service programmatically with API keys sent in the x-api-key header. You can create and manage API keys in the dashboard at https://threetone.in/app/developers/api-keys. version: '1.0' servers: - url: https://api.threetone.in description: Production security: [] paths: /v1/convai/test-invocations: get: summary: List Test Invocations description: >- Lists all test invocations with pagination support and optional search filtering. operationId: list_test_invocations_route parameters: - name: agent_id in: query required: false schema: anyOf: - type: string - type: 'null' description: Filter by agent ID title: Agent Id description: Filter by agent ID - name: page_size in: query required: false schema: type: integer maximum: 100 minimum: 1 description: >- How many Tests to return at maximum. Can not exceed 100, defaults to 30. default: 30 title: Page Size description: >- How many Tests to return at maximum. Can not exceed 100, defaults to 30. - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' description: Used for fetching next page. Cursor is returned in the response. title: Cursor description: Used for fetching next page. Cursor is returned in the response. - name: x-api-key in: header required: false schema: anyOf: - type: string - type: 'null' description: >- Your API key for programmatic access. Send it in the x-api-key header; you can create and manage keys from the Developers page. title: X-Api-Key description: >- Your API key for programmatic access. Send it in the x-api-key header; you can create and manage keys from the Developers page. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/GetTestInvocationsPageResponseModel' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' components: schemas: GetTestInvocationsPageResponseModel: properties: meta: $ref: '#/components/schemas/ListResponseMeta' default: {} results: items: $ref: '#/components/schemas/TestInvocationSummaryResponseModel' type: array title: Results next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor description: Cursor for the next page of results has_more: type: boolean title: Has More description: Whether there are more results available type: object required: - results - has_more title: GetTestInvocationsPageResponseModel HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError ListResponseMeta: properties: total: anyOf: - type: integer - type: 'null' title: Total page: anyOf: - type: integer - type: 'null' title: Page page_size: anyOf: - type: integer - type: 'null' title: Page Size type: object title: ListResponseMeta TestInvocationSummaryResponseModel: properties: id: type: string title: Id description: The ID of the test invocation agent_id: anyOf: - type: string - type: 'null' title: Agent Id description: The ID of the agent this test invocation belongs to branch_id: anyOf: - type: string - type: 'null' title: Branch Id description: The ID of the branch this test invocation was run on created_at_unix_secs: type: integer title: Created At Unix Secs description: Creation time of the test invocation in unix seconds test_run_count: type: integer title: Test Run Count description: Number of test runs in this invocation passed_count: type: integer title: Passed Count description: Number of test runs that passed failed_count: type: integer title: Failed Count description: Number of test runs that failed pending_count: type: integer title: Pending Count description: Number of test runs that are pending title: type: string title: Title description: >- Title of the test invocation - either the single test name or count of tests access_info: anyOf: - $ref: '#/components/schemas/ResourceAccessInfo' - type: 'null' description: The access information of the test invocation repeat_count: type: integer title: Repeat Count description: Number of times each test was repeated in this invocation default: 1 type: object required: - id - created_at_unix_secs - test_run_count - passed_count - failed_count - pending_count - title title: TestInvocationSummaryResponseModel ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError ResourceAccessInfo: properties: is_creator: type: boolean title: Is Creator description: Whether the user making the request is the creator of the agent creator_name: type: string title: Creator Name description: Name of the agent's creator creator_email: type: string title: Creator Email description: Email of the agent's creator role: type: string enum: - admin - editor - commenter - viewer title: Role description: The role of the user making the request anonymous_access_level_override: anyOf: - type: string enum: - admin - editor - commenter - viewer - type: 'null' title: Anonymous Access Level Override description: >- The access level for anonymous users. If None, the resource is not shared publicly. access_source: anyOf: - type: string enum: - creator - explicit - workspace_admin - workspace_default - type: 'null' title: Access Source description: >- Why the requesting user has access to this resource. 'creator' = caller is the owner. 'explicit' = caller (or one of their workspace groups) is listed in role_to_group_ids beyond the workspace-wide everyone group. 'workspace_default' = the workspace-wide everyone group is listed in role_to_group_ids (every non-anon workspace member, including admins, sees this resource). 'workspace_admin' = caller is a workspace admin and the admin seat is the *only* path to access; reserved for docs nobody else can see. Lets the UI disclose why an admin-bypass viewer sees a doc that wasn't explicitly shared with them. type: object required: - is_creator - creator_name - creator_email - role title: ResourceAccessInfo example: access_source: creator creator_email: john.doe@example.com creator_name: John Doe is_creator: true role: admin ````