> ## Documentation Index
> Fetch the complete documentation index at: https://docs.chronosphere.io/llms.txt
> Use this file to discover all available pages before exploring further.

# ListServices



## OpenAPI

````yaml openapi/api_v1_config_openapi3_DOCUMENTATION_ONLY.json GET /api/v1/config/services
openapi: 3.0.3
info:
  description: >

    The Config API provides standard HTTP/JSON REST endpoints for creating,
    reading,

    updating, deleting, and listing configurable Chronosphere resources.


    Use this link to download the raw Swagger specification:

    <a href="/api/v1/config/swagger.json">/api/v1/config/swagger.json</a>
  title: Config V1 API
  version: v1
servers:
  - url: https://{tenant}.chronosphere.io
    variables:
      tenant:
        default: tenant
        description: tenant ID assigned by the service provider
security:
  - ApiKeyAuth: []
tags:
  - name: ConfigV1
paths:
  /api/v1/config/services:
    get:
      tags:
        - Service
      operationId: ListServices
      parameters:
        - description: >-
            Sets the preferred number of items to return per page. If set to
            `0`, the

            server will use its default value. Regardless of the value
            specified, clients

            must never assume how many items will be returned.
          in: query
          name: page.max_size
          schema:
            format: int64
            type: integer
        - description: >-
            An opaque page token that identifies which page the client should
            request.

            An empty value indicates the first page.
          in: query
          name: page.token
          schema:
            type: string
        - description: >-
            Filters results by slug, where any Service with a matching slug in
            the given

            list that matches all other filters is returned.
          in: query
          name: slugs
          schema:
            items:
              type: string
            type: array
        - description: >-
            Filters results by `team_slug`, where any Service with a matching
            `team_slug` in

            the given list that matches all other filters is returned.
          in: query
          name: team_slugs
          schema:
            items:
              type: string
            type: array
        - description: >-
            Filters results by `name`, where any Service with a matching `name`
            in the given

            list that matches all other filters is returned.
          in: query
          name: names
          schema:
            items:
              type: string
            type: array
        - description: >-
            Filters results by `notification_policy_slug`, where any Service
            with a matching

            `notification_policy_slug` in the given list that matches all other
            filters is

            returned.
          in: query
          name: notification_policy_slugs
          schema:
            items:
              type: string
            type: array
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/configv1ListServicesResponse'
          description: A successful response.
        '500':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/apiError'
          description: An unexpected error response.
        default:
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/genericError'
          description: An undefined error response.
components:
  schemas:
    configv1ListServicesResponse:
      properties:
        page:
          $ref: '#/components/schemas/configv1PageResult'
        services:
          items:
            $ref: '#/components/schemas/configv1Service'
          type: array
      type: object
    apiError:
      properties:
        message:
          description: An error message describing what went wrong.
          type: string
      type: object
    genericError:
      additionalProperties: true
      type: object
    configv1PageResult:
      properties:
        next_token:
          description: |-
            An opaque page token that identifies the next page of items that the
            client should request. An empty value indicates that there are no
            more items to return.
          type: string
      type: object
    configv1Service:
      properties:
        created_at:
          description: Timestamp of when the Service was created. Cannot be set by clients.
          format: date-time
          readOnly: true
          type: string
        description:
          description: Optional. Description of the service collection.
          type: string
        name:
          description: >-
            The name of the Service. You can modify this value after the Service
            is created.
          type: string
        notification_policy_slug:
          description: >-
            Slug of the notification policy used by default for monitors in this
            service

            collection. This parameter is optional if the collection doesn't
            contain

            monitors, or if all of its monitors explicitly reference a policy.
            This

            parameter doesn't override the policy used if a monitor explicitly
            references

            a policy.
          type: string
        slug:
          description: >-
            The unique identifier of the Service. If a `slug` isn't provided,
            one is generated based on the `name` field. You can't modify this
            field after the Service is created.
          type: string
        team_slug:
          description: Slug of the team the service collection belongs to.
          type: string
        updated_at:
          description: >-
            Timestamp of when the Service was last updated. Cannot be set by
            clients.
          format: date-time
          readOnly: true
          type: string
      required:
        - name
        - team_slug
      type: object
  securitySchemes:
    ApiKeyAuth:
      description: Chronosphere API token
      in: header
      name: API-Token
      type: apiKey

````