> ## 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.

# Get available filter values

> Returns filter values for incidents based on the provided criteria.

Requires the following permissions:
- `incidents:read`



## OpenAPI

````yaml openapi_v5.yaml post /incidents/filter-values/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:
  /incidents/filter-values/v1:
    post:
      tags:
        - Incidents service
      summary: Get available filter values
      description: |-
        Returns filter values for incidents based on the provided criteria.

        Requires the following permissions:
        - `incidents:read`
      operationId: IncidentsService_GetFilterValues
      requestBody:
        content:
          application/json:
            schema:
              description: Request to get available filter values for incidents
              properties:
                filter:
                  $ref: '#/components/schemas/IncidentQueryFilter'
              title: Get filter values request
              type: object
      responses:
        '200':
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/incidents.v1.GetFilterValuesResponse'
          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:
    IncidentQueryFilter:
      title: Incident query filter
      type: object
      properties:
        applicationName:
          minItems: 0
          type: array
          items:
            minLength: 0
            type: string
            description: Filter by application names
          description: Filter by application names
        assignee:
          minItems: 0
          type: array
          items:
            minLength: 0
            type: string
            description: Filter by assignee
          description: Filter by assignee
        contextualLabels:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/ContextualLabelValues'
          description: Filter by contextual labels
        createdAtRange:
          $ref: '#/components/schemas/v1.TimeRange'
        displayLabels:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/DisplayLabelValues'
          description: Filter by display labels
        endTime:
          minLength: 0
          type: string
          description: >-
            Filters all incidents that were open in the given timeframe end time
            (deprecated, use incident_open_range instead)
          format: date-time
          deprecated: true
        incidentDurationRange:
          $ref: '#/components/schemas/v1.TimeRange'
        isMuted:
          type: boolean
          description: Indicates if the incident is muted
        metaLabels:
          minItems: 0
          type: array
          items:
            $ref: '#/components/schemas/incidents.v1.MetaLabel'
          description: Filters all incidents with the given meta labels
        metaLabelsOp:
          $ref: '#/components/schemas/v1.FilterOperator'
        searchQuery:
          $ref: '#/components/schemas/IncidentSearchQuery'
        severity:
          minItems: 0
          type: array
          items:
            $ref: '#/components/schemas/IncidentSeverity'
          description: Filter by incident severity
        startTime:
          minLength: 0
          type: string
          description: >-
            Filters all incidents that were open in the given timeframe start
            time (deprecated, use incident_open_range instead)
          format: date-time
          deprecated: true
        state:
          minItems: 0
          type: array
          items:
            $ref: '#/components/schemas/IncidentState'
          description: Filter by incident state
        status:
          minItems: 0
          type: array
          items:
            $ref: '#/components/schemas/IncidentStatus'
          description: Filter by incident status
        subsystemName:
          minItems: 0
          type: array
          items:
            minLength: 0
            type: string
            description: Filter by subsystem names
          description: Filter by subsystem names
      description: Filter configuration for incidents
      externalDocs:
        url: ''
    incidents.v1.GetFilterValuesResponse:
      title: Get filter values response
      required:
        - filtersValues
      type: object
      properties:
        filtersValues:
          $ref: '#/components/schemas/IncidentQueryFiltersValues'
      description: Response containing available filter values for incidents
      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.
    ContextualLabelValues:
      title: Contextual label values
      required:
        - contextualLabelValues
      type: object
      properties:
        contextualLabelValues:
          minItems: 0
          type: array
          items:
            minLength: 0
            type: string
            description: The contextual label values.
          description: The contextual label values.
      description: Represents contextual label values for filtering incidents
      externalDocs:
        url: ''
    v1.TimeRange:
      title: Time range
      required:
        - startTime
        - endTime
      type: object
      properties:
        endTime:
          minLength: 0
          type: string
          description: End time of the range
          format: date-time
        startTime:
          minLength: 0
          type: string
          description: Start time of the range
          format: date-time
      description: Represents a time range with start and end timestamps
      externalDocs:
        url: ''
    DisplayLabelValues:
      title: Display label values
      required:
        - displayLabelValues
      type: object
      properties:
        displayLabelValues:
          minItems: 0
          type: array
          items:
            minLength: 0
            type: string
            description: The display label values.
          description: The display label values.
      description: Represents display label values for filtering incidents
      externalDocs:
        url: ''
    incidents.v1.MetaLabel:
      title: Incident meta label
      type: object
      properties:
        key:
          minLength: 0
          type: string
          description: The key.
          example: key
        value:
          minLength: 0
          type: string
          description: The value.
          example: value
      description: Meta label.
      externalDocs:
        url: ''
    v1.FilterOperator:
      enum:
        - FILTER_OPERATOR_OR_OR_UNSPECIFIED
        - FILTER_OPERATOR_AND
      type: string
      description: Filter operator.
    IncidentSearchQuery:
      title: Incident search query
      required:
        - query
      type: object
      oneOf:
        - required:
            - incidentField
          type: object
        - required:
            - contextualLabel
          type: object
      properties:
        contextualLabel:
          minLength: 0
          type: string
          description: The contextual label to search in.
        incidentField:
          $ref: '#/components/schemas/IncidentFields'
        query:
          minLength: 0
          type: string
          description: The search query
          example: error
      description: Incident search query.
      externalDocs:
        url: ''
    IncidentSeverity:
      enum:
        - INCIDENT_SEVERITY_UNSPECIFIED
        - INCIDENT_SEVERITY_INFO
        - INCIDENT_SEVERITY_WARNING
        - INCIDENT_SEVERITY_ERROR
        - INCIDENT_SEVERITY_CRITICAL
        - INCIDENT_SEVERITY_LOW
      type: string
      description: Incident severity.
    IncidentState:
      enum:
        - INCIDENT_STATE_UNSPECIFIED
        - INCIDENT_STATE_TRIGGERED
        - INCIDENT_STATE_RESOLVED
      type: string
      description: Incident state.
    IncidentStatus:
      enum:
        - INCIDENT_STATUS_UNSPECIFIED
        - INCIDENT_STATUS_TRIGGERED
        - INCIDENT_STATUS_ACKNOWLEDGED
        - INCIDENT_STATUS_RESOLVED
      type: string
      description: Incident status.
    IncidentQueryFiltersValues:
      title: Incident query filter values
      required:
        - assigneeWithCount
        - statusWithCount
        - stateWithCount
        - severityWithCount
        - contextualLabels
        - displayLabels
        - metaLabelsWithCount
        - metaLabelsOp
      type: object
      properties:
        assigneeWithCount:
          minItems: 0
          type: array
          items:
            $ref: '#/components/schemas/AssigneeWithCount'
          description: The assignee with count.
        contextualLabels:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/ContextualLabelValuesWithCount'
          description: The contextual labels.
        displayLabels:
          type: object
          additionalProperties:
            $ref: '#/components/schemas/DisplayLabelValuesWithCount'
          description: The display labels.
        metaLabelsOp:
          $ref: '#/components/schemas/v1.FilterOperator'
        metaLabelsWithCount:
          minItems: 0
          type: array
          items:
            $ref: '#/components/schemas/IncidentMetaLabelsWithCount'
          description: The meta labels with count.
        severityWithCount:
          minItems: 0
          type: array
          items:
            $ref: '#/components/schemas/IncidentSeverityWithCount'
          description: The severity with count.
        stateWithCount:
          minItems: 0
          type: array
          items:
            $ref: '#/components/schemas/IncidentStateWithCount'
          description: The state with count.
        statusWithCount:
          minItems: 0
          type: array
          items:
            $ref: '#/components/schemas/IncidentStatusWithCount'
          description: The status with count.
      description: Incident query filters values.
      externalDocs:
        url: ''
    IncidentFields:
      enum:
        - INCIDENTS_FIELDS_UNSPECIFIED
        - INCIDENTS_FIELDS_ID
        - INCIDENTS_FIELDS_SEVERITY
        - INCIDENTS_FIELDS_NAME
        - INCIDENTS_FIELDS_CREATED_TIME
        - INCIDENTS_FIELDS_CLOSED_TIME
        - INCIDENTS_FIELDS_STATE
        - INCIDENTS_FIELDS_STATUS
        - INCIDENTS_FIELDS_LAST_STATE_UPDATE_TIME
        - INCIDENTS_FIELDS_APPLICATION_NAME
        - INCIDENTS_FIELDS_SUBSYSTEM_NAME
        - INCIDENTS_FIELDS_DURATION
      type: string
      description: Incident fields.
    AssigneeWithCount:
      title: Assignee with count
      required:
        - assignee
        - count
      type: object
      properties:
        assignee:
          minLength: 0
          type: string
          description: Assignee.
          example: assignee
        count:
          type: integer
          description: Number of items.
          format: int32
          example: 10
      externalDocs:
        url: ''
    ContextualLabelValuesWithCount:
      title: Contextual label values with count
      required:
        - valuesWithCount
      type: object
      properties:
        valuesWithCount:
          minItems: 0
          type: array
          items:
            $ref: '#/components/schemas/ContextualLabelValueWithCount'
          description: The values with count.
      externalDocs:
        url: ''
    DisplayLabelValuesWithCount:
      title: Display label values with count
      required:
        - valuesWithCount
      type: object
      properties:
        valuesWithCount:
          minItems: 0
          type: array
          items:
            $ref: '#/components/schemas/DisplayLabelValueWithCount'
          description: The values with count.
      externalDocs:
        url: ''
    IncidentMetaLabelsWithCount:
      title: Incident meta labels with count
      required:
        - metaLabel
        - count
      type: object
      properties:
        count:
          type: integer
          description: Number of items.
          format: int32
          example: 10
        metaLabel:
          $ref: '#/components/schemas/incidents.v1.MetaLabel'
      externalDocs:
        url: ''
    IncidentSeverityWithCount:
      title: Incident severity with count
      required:
        - severity
        - count
      type: object
      properties:
        count:
          type: integer
          description: Number of items.
          format: int32
          example: 10
        severity:
          $ref: '#/components/schemas/IncidentSeverity'
      externalDocs:
        url: ''
    IncidentStateWithCount:
      title: Incident state with count
      required:
        - state
        - count
      type: object
      properties:
        count:
          type: integer
          description: Number of items.
          format: int32
          example: 10
        state:
          $ref: '#/components/schemas/IncidentState'
      externalDocs:
        url: ''
    IncidentStatusWithCount:
      title: Incident status with count
      required:
        - status
        - count
      type: object
      properties:
        count:
          type: integer
          description: Number of items.
          format: int32
          example: 10
        status:
          $ref: '#/components/schemas/IncidentStatus'
      externalDocs:
        url: ''
    ContextualLabelValueWithCount:
      title: Contextual label value with count
      required:
        - contextualLabelValue
        - count
      type: object
      properties:
        contextualLabelValue:
          minLength: 0
          type: string
          description: The contextual label value.
          example: contextual_label_value
        count:
          type: integer
          description: Number of items.
          format: int32
          example: 10
      externalDocs:
        url: ''
    DisplayLabelValueWithCount:
      title: Display label value with count
      required:
        - displayLabelValue
        - count
      type: object
      properties:
        count:
          type: integer
          description: Number of items.
          format: int32
          example: 10
        displayLabelValue:
          minLength: 0
          type: string
          description: The display label value.
          example: display_label_value
      externalDocs:
        url: ''
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: API key authentication

````