---
title: "Search tests events"
method: POST
path: "/api/v2/ci/tests/events/search"
tags: ["CI Visibility Tests"]
---

# Search tests events

`POST /api/v2/ci/tests/events/search`

List endpoint returns CI Visibility test events that match a [search query](https://docs.datadoghq.com/continuous_integration/explorer/search_syntax/).
[Results are paginated similarly to logs](https://docs.datadoghq.com/logs/guide/collect-multiple-logs-with-pagination).

Use this endpoint to build complex events filtering and search.

## Request body

- CIAppTestEventsRequest — The request for a tests search.
  - `filter` CIAppTestsQueryFilter — The search and filter query settings.
    - `from` string — The minimum time for the requested events; supports date, math, and regular timestamps (in milliseconds).
    - `query` string — The search query following the CI Visibility Explorer search syntax.
    - `to` string — The maximum time for the requested events, supports date, math, and regular timestamps (in milliseconds).
  - `options` CIAppQueryOptions — Global query options that are used during the query. Only supply timezone or time offset, not both. Otherwise, the query fails.
    - `time_offset` integer — The time offset (in seconds) to apply to the query.
    - `timezone` string — The timezone can be specified as GMT, UTC, an offset from UTC (like UTC+1), or as a Timezone Database identifier (like America/New_York).
  - `page` CIAppQueryPageOptions — Paging attributes for listing events.
    - `cursor` string — List following results with a cursor provided in the previous query.
    - `limit` integer — Maximum number of events in the response.
  - `sort` 'timestamp' | '-timestamp' — Sort parameters when querying events.

## Response `200`

OK

- CIAppTestEventsResponse — Response object with all test events matching the request and pagination information.
  - `data` CIAppTestEvent[] — Array of events matching the request.
    - `attributes` CIAppEventAttributes — JSON object containing all event attributes and their associated values.
      - `attributes` object — JSON object of attributes from CI Visibility test events.
      - `tags` string[] — Array of tags associated with your event.
      - `test_level` 'session' | 'module' | 'suite' | 'test' — Test run level.
    - `id` string — Unique ID of the event.
    - `type` 'citest' — Type of the event.
  - `links` CIAppResponseLinks — Links attributes.
    - `next` string — Link for the next set of results. The request can also be made using the POST endpoint.
  - `meta` CIAppResponseMetadataWithPagination — The metadata associated with a request.
    - `elapsed` integer — The time elapsed in milliseconds.
    - `page` CIAppResponsePage — Paging attributes.
      - `after` string — The cursor to use to get the next results, if any. To make the next request, use the same parameters with the addition of `page[cursor]`.
    - `request_id` string — The identifier of the request.
    - `status` 'done' | 'timeout' — The status of the response.
    - `warnings` CIAppWarning[] — A list of warnings (non-fatal errors) encountered. Partial results may return if warnings are present in the response.
      - `code` string — A unique code for this type of warning.
      - `detail` string — A detailed explanation of this specific warning.
      - `title` string — A short human-readable summary of the warning.

## Other responses

- `400` — Bad Request
- `403` — Not Authorized
- `429` — Too many requests

---

[API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)