> ## Documentation Index > Fetch the complete documentation index at: https://docs.coralogix.com/llms.txt > Use this file to discover all available pages before exploring further. # List Slos > Returns SLOs matching the given criteria. ## OpenAPI ````yaml openapi_v5.yaml get /slo/slos/v1 openapi: 3.0.0 info: title: '' version: 1.0.0 servers: - url: https://api.coralogix.com/mgmt/openapi/5 - url: https://api.eu2.coralogix.com/mgmt/openapi/5 - url: https://api.coralogix.us/mgmt/openapi/5 - url: https://api.cx498.coralogix.com/mgmt/openapi/5 - url: https://api.coralogix.in/mgmt/openapi/5 - url: https://api.coralogixsg.com/mgmt/openapi/5 - url: https://api.ap3.coralogix.com/mgmt/openapi/5 security: - apiKeyAuth: [] tags: - name: AI Applications Service description: Manage the catalog of AI applications discovered from spans. externalDocs: url: '' - name: AI Evaluations Service description: >- Manage AI evaluations and the custom evaluation catalog for AI applications. externalDocs: url: '' - name: API Keys Admin Service description: Administrative operations for API Keys management. externalDocs: url: '' - name: API Keys Service description: Manage your API Keys. externalDocs: url: '' - name: Actions Service description: View and manage your Actions. externalDocs: url: '' - name: Alert Scheduler Rule service description: Manage your alert scheduler rules. externalDocs: url: '' - name: Alert definitions service description: >- View and manage your alerts using alert definitions - data structures that contain the configuration required to create an alert. externalDocs: description: Learn more about alerts in our documentation url: https://coralogix.com/docs/user-guides/alerting/introduction-to-alerts/ - name: Alert events service description: >- Get information regarding your alert events - instances of alerts being triggered. externalDocs: description: Learn more about alert events and incidents in our documentation. url: https://coralogix.com/docs/user-guides/alerting/incidents/ - name: Case Events service description: Manage case events, comments, and external thread synchronization. externalDocs: url: '' - name: Case Settings service description: Manage case settings team configurations. externalDocs: url: '' - name: Cases notification service description: Track notification adjacent data for cases. externalDocs: url: '' - name: Cases service description: >- Manage cases throughout their lifecycle. Create, view, assign, acknowledge, unacknowledge, resolve, and close cases to streamline investigations and follow-ups. externalDocs: description: Learn more about Cases in our documentation url: https://coralogix.com/docs/user-guides/cases/ - name: Connector Schema service description: Retrieve connector schemas for notification center integrations externalDocs: description: Learn more about connectors in our documentation url: >- https://coralogix.com/docs/user-guides/notification-center/connectors/introduction/ - name: Connectors service description: >- View and manage your connectors - integration instances for notification destinations externalDocs: description: Lean more about connectors in our documentation url: >- https://coralogix.com/docs/user-guides/notification-center/connectors/introduction/ - name: Contextual data integration service description: Query for contextual data integration information. externalDocs: url: '' - name: Custom Enrichments Service description: Manage your enrichments. externalDocs: url: '' - name: Dashboard folders service description: Manage your dashboard folders. externalDocs: url: '' - name: Dashboard service description: Get information about the Coralogix Dashboard catalog. externalDocs: url: '' - name: Data Usage Query service description: >- Query billable data usage through the public Coralogix API using daily or hourly bucketed aggregations over supported labels. externalDocs: url: '' - name: Data Usage Service description: A service to manage data usage metrics. externalDocs: url: '' - name: Enrichments Service description: Manage your enrichments. externalDocs: url: '' - name: Entities service description: Query information about registered entities in the notification center externalDocs: description: Lean more about the notification center in our documentation url: https://coralogix.com/docs/user-guides/notification-center/introduction/ - name: Events Service description: A service for querying events. externalDocs: description: Learn more about alerts in our documentation url: https://coralogix.com/docs/user-guides/alerting/introduction-to-alerts/ - name: Events2Metrics Service description: Manage your events2metrics. externalDocs: url: '' - name: Extension deployment service description: A service that enables querying for extension deployment information. externalDocs: description: Find out more about extensions in our documentation. url: https://coralogix.com/docs/integrations/extensions/ - name: Extension service description: A service that enables querying for extension information. externalDocs: description: Learn more about extensions in our documentation. url: https://coralogix.com/docs/integrations/extensions/ - name: Folders for views service description: Create and manage view folders. externalDocs: url: '' - name: Global routers service description: >- View and manage your global routers - entities that direct notifications to configured destinations based on conditions externalDocs: description: Lean more about global routers in our documentation url: >- https://coralogix.com/docs/user-guides/notification-center/routing/introduction/ - name: IP access service description: >- IP access service provides the API for managing company IP access settings. externalDocs: url: '' - name: Incidents service description: >- Handle all operations related to incident management within Coralogix. Identify, manage, and resolve incidents efficiently through automated workflows and team collaboration. externalDocs: description: Find out more about incident management in our documentation url: https://coralogix.com/docs/user-guides/alerting/incidents/ - name: Integration service description: A service that enables querying for integration information. externalDocs: description: Find out more about integrations in our documentation. url: https://coralogix.com/docs/integrations/getting-started/ - name: Metrics Data Archive Service description: View and manage your storage targets for metrics. externalDocs: description: Find out more about archives url: >- https://coralogix.com/docs/user-guides/data-flow/s3-archive/connect-s3-archive/ - name: Notifications testing service description: >- Test your notification center configurations including connectors, presets, and templates externalDocs: description: Lean more about the notification center in our documentation url: https://coralogix.com/docs/user-guides/notification-center/introduction/ - name: Outgoing webhooks service externalDocs: description: Find out more about outbound webhooks in our documentation. url: >- https://coralogix.com/docs/user-guides/alerting/outbound-webhooks/generic-outbound-webhooks-alert-webhooks/ - name: Policies Service description: View and manage your TCO policies externalDocs: url: '' - name: Presets service description: >- View and manage your presets - pre-configured templates for notification content rendering externalDocs: description: Lean more about presets in our documentation url: >- https://coralogix.com/docs/user-guides/notification-center/presets/introduction/ - name: Quota Allocation Rule Set service description: Manage quota allocation rules for different entity types. externalDocs: url: '' - name: Recording Rules Service description: A service to manage recording rules. externalDocs: url: '' - name: Retentions Service description: View and manage retentions externalDocs: url: '' - name: Role Management Service description: Service for managing system and custom roles. externalDocs: url: '' - name: Rule Groups Service description: A service to manage rule groups. externalDocs: url: '' - name: SAML Configuration Service description: Manage your SAML configuration externalDocs: url: '' - name: Scopes Service description: A service to manage scopes externalDocs: url: '' - name: Slos Service description: A service for managing Service Level Objectives (SLOs). externalDocs: url: '' - name: Target Service description: View and manage your storage targets for logs. externalDocs: description: Find out more about archives url: >- https://coralogix.com/docs/user-guides/data-flow/s3-archive/connect-s3-archive/ - name: Team Groups Management Service description: Manage Team Groups. externalDocs: url: '' - name: Users Management Service description: >- Manage team members (users) including creation, updates, search, and status management. externalDocs: url: '' - name: Views service description: Create and manage views. externalDocs: url: '' paths: /slo/slos/v1: get: tags: - Slos Service summary: List Slos description: Returns SLOs matching the given criteria. operationId: SlosService_ListSlos parameters: - description: The filters. in: query name: filters required: false schema: description: The filters. items: description: A filter for SLOs, consisting of a field and a predicate externalDocs: url: '' properties: field: title: SloFilterField type: object oneOf: - required: - constFilter type: object - required: - labelName type: object - required: - sloType type: object - required: - productType type: object - required: - serviceName type: object - required: - ownershipServiceValues type: object - required: - ownershipEnvironmentValues type: object - required: - ownershipTeamValues type: object - type: object not: anyOf: - required: - constFilter type: object - required: - labelName type: object - required: - sloType type: object - required: - productType type: object - required: - serviceName type: object - required: - ownershipServiceValues type: object - required: - ownershipEnvironmentValues type: object - required: - ownershipTeamValues type: object properties: constFilter: $ref: '#/components/schemas/SloConstantFilterField' labelName: minLength: 0 type: string description: Filter by a specific SLO label key. example: environment ownershipEnvironmentValues: $ref: '#/components/schemas/StringValues' ownershipServiceValues: $ref: '#/components/schemas/StringValues' ownershipTeamValues: $ref: '#/components/schemas/StringValues' productType: type: boolean description: Filter discriminator for SLO product type values. serviceName: minLength: 0 type: string description: >- Filter by service name from the APM SLI services list (not ownership tags). Only valid for APM product SLOs. MUST be used together with a product_type filter that includes APM; the server may reject the request otherwise. To filter by configured ownership service on any SLO type, use ownership_service_values instead. example: payment-service sloType: type: boolean description: Filter discriminator for SLO type values. description: Field used for filtering SLOs externalDocs: url: '' predicate: description: Predicate used for filtering SLOs externalDocs: url: '' properties: is: title: IsFilterPredicate type: object oneOf: - required: - stringValues type: object - required: - typeValues type: object - required: - productTypeValues type: object - type: object not: anyOf: - required: - stringValues type: object - required: - typeValues type: object - required: - productTypeValues type: object properties: productTypeValues: $ref: '#/components/schemas/ProductTypeValues' stringValues: $ref: '#/components/schemas/StringValues' typeValues: $ref: '#/components/schemas/TypeValues' description: >- Predicate for SLO filters that checks if a field is equal to one of multiple values externalDocs: url: '' title: SloFilterPredicate type: object title: SloFilter type: object minItems: 0 type: array responses: '200': content: application/json: schema: $ref: '#/components/schemas/ListSlosResponse' description: '' '400': content: application/json: schema: $ref: '#/components/schemas/Error' description: Bad Request '401': content: application/json: schema: $ref: '#/components/schemas/Error' description: Unauthorized request '500': content: application/json: schema: $ref: '#/components/schemas/Error' description: Internal server error externalDocs: url: '' components: schemas: SloConstantFilterField: enum: - SLO_CONST_FILTER_FIELD_UNSPECIFIED - SLO_CONST_FILTER_FIELD_USER_NAME - SLO_CONST_FILTER_FIELD_SLO_NAME type: string description: Slo constant filter field. StringValues: type: object properties: values: minItems: 0 type: array items: minLength: 0 type: string description: The values. description: The values. description: String values. externalDocs: url: '' ProductTypeValues: type: object properties: values: minItems: 0 type: array items: $ref: '#/components/schemas/SloProductType' description: The values. description: Product type values. externalDocs: url: '' TypeValues: type: object properties: values: minItems: 0 type: array items: $ref: '#/components/schemas/SloType' description: The values. description: Type values. externalDocs: url: '' ListSlosResponse: title: ListSlosResponse required: - slos type: object properties: slos: minItems: 0 type: array items: $ref: '#/components/schemas/Slo' description: The slos. description: Response containing a list of SLOs. externalDocs: url: '' Error: type: object properties: code: maximum: 599 minimum: 100 type: integer description: HTTP status code of the error (for example 400, 404, 500). format: int32 message: maxLength: 4096 minLength: 0 pattern: ^[\s\S]*$ type: string description: Human-readable description of the error. description: Standard error response body returned for a failed request. SloProductType: enum: - SLO_PRODUCT_TYPE_UNSPECIFIED - SLO_PRODUCT_TYPE_APM type: string description: Slo product type. SloType: enum: - SLO_TYPE_REQUEST - SLO_TYPE_WINDOW type: string description: Slo type. Slo: title: Slo type: object oneOf: - required: - requestBasedMetricSli type: object - required: - windowBasedMetricSli type: object - required: - apmSli type: object - type: object not: anyOf: - required: - requestBasedMetricSli type: object - required: - windowBasedMetricSli type: object - required: - apmSli type: object properties: apmSli: $ref: '#/components/schemas/ApmSli' apmSliMetadata: $ref: '#/components/schemas/ApmSli' createTime: minLength: 0 type: string description: RFC3339 timestamp of when the SLO was created. format: date-time creator: minLength: 0 type: string description: Email or identifier of the user who created the SLO. example: test@domain.com description: minLength: 0 type: string description: Human-readable description of the SLO. example: A brief description of my SLO grouping: $ref: '#/components/schemas/v1.Grouping' id: minLength: 0 type: string description: Unique identifier of the SLO. example: b11919d5-ef85-4bb1-8655-02640dbe94d9 labels: type: object additionalProperties: minLength: 0 type: string description: List of labels. name: minLength: 0 type: string description: Human-readable display name for the SLO. example: Example Slo Name ownershipTags: $ref: '#/components/schemas/SloOwnershipTags' productType: $ref: '#/components/schemas/SloProductType' requestBasedMetricSli: $ref: '#/components/schemas/RequestBasedMetricSli' revision: $ref: '#/components/schemas/v1.Revision' sloTimeFrame: $ref: '#/components/schemas/SloTimeFrame' sloType: $ref: '#/components/schemas/SloType' targetThresholdPercentage: type: number description: >- Target compliance percentage threshold for the SLO (e.g., 99.9 for three nines). format: float example: 99.999 type: minLength: 0 type: string description: 'Deprecated: SLO type string. Use slo_type instead.' example: request deprecated: true updateTime: minLength: 0 type: string description: Timestamp of the last update. format: date-time windowBasedMetricSli: $ref: '#/components/schemas/WindowBasedMetricSli' description: Definition of an SLO externalDocs: url: '' ApmSli: title: ApmSli type: object oneOf: - required: - errorConfig type: object - required: - latencyConfig type: object - type: object not: anyOf: - required: - errorConfig type: object - required: - latencyConfig type: object properties: errorConfig: $ref: '#/components/schemas/ApmErrorSli' filters: minItems: 0 type: array items: $ref: '#/components/schemas/ApmFilter' description: Additional label-based filters to apply to the metrics groupingKeys: minItems: 0 type: array items: minLength: 0 type: string description: Labels to group SLO results by description: Labels to group SLO results by example: - environment - region latencyConfig: $ref: '#/components/schemas/ApmLatencySli' services: minItems: 0 type: array items: minLength: 0 type: string description: List of service names to monitor description: List of service names to monitor example: - my-service - payment-service description: Definition of an APM-based SLI with automatic query generation externalDocs: url: '' v1.Grouping: title: Grouping type: object properties: labels: minItems: 0 type: array items: minLength: 0 type: string description: List of labels. description: List of labels. description: Definition of the SLO grouping fields externalDocs: url: '' SloOwnershipTags: title: SloOwnershipTags type: object properties: environment: $ref: '#/components/schemas/SloOwnershipTag' service: $ref: '#/components/schemas/SloOwnershipTag' team: $ref: '#/components/schemas/SloOwnershipTag' description: >- Service, environment, and team ownership for the SLO group. At most one SloOwnershipTag per dimension; omit a dimension when unset. externalDocs: url: '' RequestBasedMetricSli: title: RequestBasedMetricSli type: object properties: goodEvents: $ref: '#/components/schemas/Metric' totalEvents: $ref: '#/components/schemas/Metric' description: Definition of a request-based SLI based on metrics externalDocs: url: '' v1.Revision: title: Revision type: object properties: revision: type: integer description: The revision. format: int32 example: 1 updateTime: minLength: 0 type: string description: Timestamp of the last update. format: date-time description: >- The revision of the slo, used to differentiate between different versions of the same SLO externalDocs: url: '' SloTimeFrame: enum: - SLO_TIME_FRAME_UNSPECIFIED - SLO_TIME_FRAME_7_DAYS - SLO_TIME_FRAME_14_DAYS - SLO_TIME_FRAME_21_DAYS - SLO_TIME_FRAME_28_DAYS type: string description: Slo time frame. WindowBasedMetricSli: title: WindowBasedMetricSli type: object properties: comparisonOperator: $ref: '#/components/schemas/ComparisonOperator' missingDataStrategy: $ref: '#/components/schemas/MissingDataStrategy' query: $ref: '#/components/schemas/Metric' threshold: type: number description: Threshold value. format: float example: 0.95 window: $ref: '#/components/schemas/WindowSloWindow' description: Definition of a window-based SLI based on metrics externalDocs: url: '' ApmErrorSli: title: ApmErrorSli type: object additionalProperties: false description: Configuration for error-based APM SLI externalDocs: url: '' ApmFilter: title: ApmFilter type: object properties: key: minLength: 0 type: string description: Label/tag name to filter on example: environment value: minLength: 0 type: string description: >- Deprecated: use values instead. Single value to match (kept for backward compatibility) example: production deprecated: true values: minItems: 0 type: array items: minLength: 0 type: string description: >- Preferred: multiple values to match (OR semantics, e.g. status IN [500, 503]) example: '500' description: >- Preferred: multiple values to match (OR semantics, e.g. status IN [500, 503]) description: >- Key-value filter for APM metrics. Supports single value (legacy) or multiple values (OR semantics) externalDocs: url: '' ApmLatencySli: title: ApmLatencySli type: object oneOf: - required: - quantile type: object - required: - average type: object - type: object not: anyOf: - required: - quantile type: object - required: - average type: object properties: average: $ref: '#/components/schemas/ApmLatencyAverage' quantile: $ref: '#/components/schemas/ApmLatencyQuantile' threshold: type: number description: >- Threshold in milliseconds. Good when latency <= threshold, bad when latency > threshold. format: float example: 500 timeWindow: $ref: '#/components/schemas/WindowSloWindow' description: Configuration for latency-based APM SLI externalDocs: url: '' SloOwnershipTag: title: SloOwnershipTag type: object properties: labelKeys: minItems: 0 type: array items: minLength: 0 type: string description: >- Metric label names to use as sources (label-driven). Actual values come from series at query time. Empty if not using label-driven for this dimension. description: >- Metric label names to use as sources (label-driven). Actual values come from series at query time. Empty if not using label-driven for this dimension. example: - deployment_environment - k8s_namespace resolvedValues: minItems: 0 type: array items: minLength: 0 type: string description: >- Flat, deduplicated union of static_values and the values resolved from label_keys across observed permutations (empties excluded). Empty when neither source yields any value. Provides a single searchable list of values for this ownership tag, regardless of source. description: >- Flat, deduplicated union of static_values and the values resolved from label_keys across observed permutations (empties excluded). Empty when neither source yields any value. Provides a single searchable list of values for this ownership tag, regardless of source. example: - checkout-api - production - staging - payments-ns staticValues: minItems: 0 type: array items: minLength: 0 type: string description: >- Group-wide static values (broad). Empty if not using broad for this dimension. description: >- Group-wide static values (broad). Empty if not using broad for this dimension. example: - checkout-api description: >- Ownership for one dimension (service, environment, or team). static_values are group-wide (broad) assignments. label_keys are metric label names whose values are read per permutation (label-driven). Both may be set; when both lists are empty, that dimension is unset. externalDocs: url: '' Metric: title: Metric type: object properties: query: minLength: 0 type: string description: Query string. example: sum(rate(http_requests_total{status="200"}[5m])) description: Definition of a metric used in SLOs externalDocs: url: '' ComparisonOperator: enum: - COMPARISON_OPERATOR_UNSPECIFIED - COMPARISON_OPERATOR_GREATER_THAN - COMPARISON_OPERATOR_GREATER_THAN_OR_EQUALS - COMPARISON_OPERATOR_LESS_THAN - COMPARISON_OPERATOR_LESS_THAN_OR_EQUALS type: string description: Comparison operator. MissingDataStrategy: enum: - MISSING_DATA_STRATEGY_UNCOUNTED - MISSING_DATA_STRATEGY_GOOD - MISSING_DATA_STRATEGY_BAD type: string description: Missing data strategy. WindowSloWindow: enum: - WINDOW_SLO_WINDOW_UNSPECIFIED - WINDOW_SLO_WINDOW_1_MINUTE - WINDOW_SLO_WINDOW_5_MINUTES type: string description: Window slo window. ApmLatencyAverage: title: ApmLatencyAverage type: object additionalProperties: false description: Average/mean-based latency measurement externalDocs: url: '' ApmLatencyQuantile: title: ApmLatencyQuantile type: object properties: percentile: type: number description: Percentile for latency SLOs (0.95 = P95, 0.99 = P99) format: float example: 0.95 description: Quantile/percentile-based latency measurement externalDocs: url: '' securitySchemes: apiKeyAuth: type: apiKey in: header name: Authorization description: API key authentication ````