---
title: "Search for SLOs"
method: GET
path: "/api/v1/slo/search"
tags: ["Service Level Objectives"]
---

# Search for SLOs

`GET /api/v1/slo/search`

Get a list of service level objective objects for your organization.

## Query parameters

- `query` string
- `page[size]` integer
- `page[number]` integer
- `include_facets` boolean

## Response `200`

OK

- SearchSLOResponse — A search SLO response containing results from the search query.
  - `data` SearchSLOResponseData — Data from search SLO response.
    - `attributes` SearchSLOResponseDataAttributes — Attributes
      - `facets` SearchSLOResponseDataAttributesFacets — Facets
        - `all_tags` SearchSLOResponseDataAttributesFacetsObjectString[] — All tags associated with an SLO.
          - `count` integer — Count
          - `name` string — Facet
        - `creator_name` SearchSLOResponseDataAttributesFacetsObjectString[] — Creator of an SLO.
          - `count` integer — Count
          - `name` string — Facet
        - `env_tags` SearchSLOResponseDataAttributesFacetsObjectString[] — Tags with the `env` tag key.
          - `count` integer — Count
          - `name` string — Facet
        - `service_tags` SearchSLOResponseDataAttributesFacetsObjectString[] — Tags with the `service` tag key.
          - `count` integer — Count
          - `name` string — Facet
        - `slo_type` SearchSLOResponseDataAttributesFacetsObjectInt[] — Type of SLO.
          - `count` integer — Count
          - `name` number, double — Facet
        - `target` SearchSLOResponseDataAttributesFacetsObjectInt[] — SLO Target
          - `count` integer — Count
          - `name` number, double — Facet
        - `team_tags` SearchSLOResponseDataAttributesFacetsObjectString[] — Tags with the `team` tag key.
          - `count` integer — Count
          - `name` string — Facet
        - `timeframe` SearchSLOResponseDataAttributesFacetsObjectString[] — Timeframes of SLOs.
          - `count` integer — Count
          - `name` string — Facet
      - `slos` SearchServiceLevelObjective[] — SLOs
        - `data` SearchServiceLevelObjectiveData — A service level objective ID and attributes.
          - `attributes` SearchServiceLevelObjectiveAttributes — A service level objective object includes a service level indicator, thresholds for one or more timeframes, and metadata (`name`, `description`, and `tags`).
            - `all_tags` string[] — A list of tags associated with this service level objective. Always included in service level objective responses (but may be empty).
            - `created_at` integer — Creation timestamp (UNIX time in seconds) Always included in service level objective responses.
            - `creator` SLOCreator, nullable — The creator of the SLO
              - …
            - `description` string, nullable — A user-defined description of the service level objective. Always included in service level objective responses (but may be `null`). Optional in create/update requests.
            - `env_tags` string[] — Tags with the `env` tag key.
            - `groups` string[], nullable — A list of (up to 100) monitor groups that narrow the scope of a monitor service level objective. Included in service level objective responses if it is not empty.
            - `modified_at` integer — Modification timestamp (UNIX time in seconds) Always included in service level objective responses.
            - `monitor_ids` integer[], nullable — A list of monitor ids that defines the scope of a monitor service level objective.
            - `name` string — The name of the service level objective object.
            - `overall_status` SLOOverallStatuses[] — calculated status and error budget remaining.
              - …
            - `query` SearchSLOQuery, nullable — A metric-based SLO. **Required if type is `metric`**. Note that Datadog only allows the sum by aggregator to be used because this will sum up all request counts instead of averaging them, or taking the max or min of all of those requests.
              - …
            - `service_tags` string[] — Tags with the `service` tag key.
            - `slo_type` 'metric' | 'monitor' | 'time_slice' — The type of the service level objective.
            - `status` SLOStatus — Status of the SLO's primary timeframe.
              - …
            - `team_tags` string[] — Tags with the `team` tag key.
            - `thresholds` SearchSLOThreshold[] — The thresholds (timeframes and associated targets) for this service level objective object.
              - …
          - `id` string — A unique identifier for the service level objective object. Always included in service level objective responses.
          - `type` string — The type of the object, must be `slo`.
    - `type` string — Type of service level objective result.
  - `links` SearchSLOResponseLinks — Pagination links.
    - `first` string — Link to last page.
    - `last` string, nullable — Link to first page.
    - `next` string — Link to the next page.
    - `prev` string, nullable — Link to previous page.
    - `self` string — Link to current page.
  - `meta` SearchSLOResponseMeta — Searches metadata returned by the API.
    - `pagination` SearchSLOResponseMetaPage — Pagination metadata returned by the API.
      - `first_number` integer — The first number.
      - `last_number` integer — The last number.
      - `next_number` integer — The next number.
      - `number` integer — The page number.
      - `prev_number` integer — The previous page number.
      - `size` integer — The size of the response.
      - `total` integer — The total number of SLOs in the response.
      - `type` string — Type of pagination.

## Other responses

- `400` — Bad Request
- `403` — Forbidden
- `429` — Too many requests

---

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