---
title: "Show Alert Routes V2"
method: GET
path: "/v2/alert_routes/{id}"
tags: ["Alert Routes V2"]
---

# Show Alert Routes V2

`GET /v2/alert_routes/{id}`

Show an alert route.

We recommend you create alert routes in the incident.io dashboard where we allow
previewing filter and grouping rules.

## Path parameters

- `id` string, required

## Response `200`

OK response.

- AlertRoutesV2ShowResponseBody
  - `alert_route` AlertRouteV2, required
    - `condition_groups` ConditionGroupV2[], required — What condition groups must be true for this alert route to fire?
      - `conditions` ConditionV2[], required — All conditions in this list must be satisfied for the group to be satisfied
        - `operation` ConditionOperationV2, required
          - `label` string, required — Human readable label to be displayed for user to select
          - `value` string, required — Unique identifier for this option
        - `param_bindings` EngineParamBindingV2[], required — Bindings for the operation parameters
          - `array_value` EngineParamBindingValueV2[] — If array_value is set, this helps render the values
            - `label` string, required — Human readable label to be displayed for user to select
            - `literal` string — If set, this is the literal value of the step parameter
            - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
          - `value` EngineParamBindingValueV2
            - `label` string, required — Human readable label to be displayed for user to select
            - `literal` string — If set, this is the literal value of the step parameter
            - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
        - `subject` ConditionSubjectV2, required
          - `label` string, required — Human readable identifier for the subject
          - `reference` string, required — Reference into the scope for the value of the subject
    - `defer_time_seconds` integer, required — How long should the escalation defer time be?
    - `escalation_bindings` AlertRouteEscalationBindingV2[], required — Which escalation paths should this alert route escalate to?
      - `binding` EngineParamBindingV2, required
        - `array_value` EngineParamBindingValueV2[] — If array_value is set, this helps render the values
          - `label` string, required — Human readable label to be displayed for user to select
          - `literal` string — If set, this is the literal value of the step parameter
          - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
        - `value` EngineParamBindingValueV2
          - `label` string, required — Human readable label to be displayed for user to select
          - `literal` string — If set, this is the literal value of the step parameter
          - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
    - `expressions` ExpressionV2[] — The expressions used in this template
      - `else_branch` ExpressionElseBranchV2
        - `result` EngineParamBindingV2, required
          - `array_value` EngineParamBindingValueV2[] — If array_value is set, this helps render the values
            - `label` string, required — Human readable label to be displayed for user to select
            - `literal` string — If set, this is the literal value of the step parameter
            - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
          - `value` EngineParamBindingValueV2
            - `label` string, required — Human readable label to be displayed for user to select
            - `literal` string — If set, this is the literal value of the step parameter
            - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
      - `label` string, required — The human readable label of the expression
      - `operations` ExpressionOperationV2[], required
        - `branches` ExpressionBranchesOptsV2
          - `branches` ExpressionBranchV2[], required — The branches to apply for this operation
            - `condition_groups` ConditionGroupV2[], required — When one of these condition groups are satisfied, this branch will be evaluated
              - …
            - `result` EngineParamBindingV2, required
              - …
          - `returns` ReturnsMetaV2, required
            - `array` boolean, required — Whether the return value should be single or multi-value
            - `type` string, required — Expected return type of this expression (what to try casting the result to)
        - `filter` ExpressionFilterOptsV2
          - `condition_groups` ConditionGroupV2[], required — The condition groups to apply in this filter. Only one group needs to be satisfied for the filter to pass.
            - `conditions` ConditionV2[], required — All conditions in this list must be satisfied for the group to be satisfied
              - …
        - `navigate` ExpressionNavigateOptsV2
          - `reference` string, required — The reference within the scope to navigate to
          - `reference_label` string, required — The name of the reference to navigate to
        - `operation_type` 'navigate' | 'filter' | 'count' | 'min' | 'max' | 'sum' | 'random' | 'first' | 'parse' | 'branches', required — The type of the operation
        - `parse` ExpressionParseOptsV2
          - `returns` ReturnsMetaV2, required
            - `array` boolean, required — Whether the return value should be single or multi-value
            - `type` string, required — Expected return type of this expression (what to try casting the result to)
          - `source` string, required — Source expression that is evaluated to a result
        - `returns` ReturnsMetaV2, required
          - `array` boolean, required — Whether the return value should be single or multi-value
          - `type` string, required — Expected return type of this expression (what to try casting the result to)
      - `reference` string, required — A short ID that can be used to reference the expression
      - `returns` ReturnsMetaV2, required
        - `array` boolean, required — Whether the return value should be single or multi-value
        - `type` string, required — Expected return type of this expression (what to try casting the result to)
      - `root_reference` string, required — The root reference for this expression (i.e. where the expression starts)
    - `grouping_keys` GroupingKeyV2[], required — Which attributes should this alert route use to group alerts?
      - `id` string, required — Unique identifier of the alert attribute the user wishes to group on
    - `grouping_window_seconds` integer, required — How large should the grouping window be?
    - `id` string, required — Unique identifier for this alert route config
    - `name` string, required — The name of this alert route config, for the user's reference
    - `template` AlertRouteIncidentTemplateV2
      - `custom_field_priorities` object, required — lookup of the priority options for each custom field in the template
      - `custom_fields` object — Custom field keys mapped to values
      - `incident_mode` EngineParamBindingV2
        - `array_value` EngineParamBindingValueV2[] — If array_value is set, this helps render the values
          - `label` string, required — Human readable label to be displayed for user to select
          - `literal` string — If set, this is the literal value of the step parameter
          - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
        - `value` EngineParamBindingValueV2
          - `label` string, required — Human readable label to be displayed for user to select
          - `literal` string — If set, this is the literal value of the step parameter
          - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
      - `incident_type` EngineParamBindingV2
        - `array_value` EngineParamBindingValueV2[] — If array_value is set, this helps render the values
          - `label` string, required — Human readable label to be displayed for user to select
          - `literal` string — If set, this is the literal value of the step parameter
          - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
        - `value` EngineParamBindingValueV2
          - `label` string, required — Human readable label to be displayed for user to select
          - `literal` string — If set, this is the literal value of the step parameter
          - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
      - `name` EngineParamBindingV2
        - `array_value` EngineParamBindingValueV2[] — If array_value is set, this helps render the values
          - `label` string, required — Human readable label to be displayed for user to select
          - `literal` string — If set, this is the literal value of the step parameter
          - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
        - `value` EngineParamBindingValueV2
          - `label` string, required — Human readable label to be displayed for user to select
          - `literal` string — If set, this is the literal value of the step parameter
          - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
      - `priority_severity` 'severity-first-wins' | 'severity-max', required — binding to use to resolve the workspace to create an incident in
      - `severity` EngineParamBindingV2
        - `array_value` EngineParamBindingValueV2[] — If array_value is set, this helps render the values
          - `label` string, required — Human readable label to be displayed for user to select
          - `literal` string — If set, this is the literal value of the step parameter
          - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
        - `value` EngineParamBindingValueV2
          - `label` string, required — Human readable label to be displayed for user to select
          - `literal` string — If set, this is the literal value of the step parameter
          - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
      - `summary` EngineParamBindingV2
        - `array_value` EngineParamBindingValueV2[] — If array_value is set, this helps render the values
          - `label` string, required — Human readable label to be displayed for user to select
          - `literal` string — If set, this is the literal value of the step parameter
          - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
        - `value` EngineParamBindingValueV2
          - `label` string, required — Human readable label to be displayed for user to select
          - `literal` string — If set, this is the literal value of the step parameter
          - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
      - `workspace` EngineParamBindingV2
        - `array_value` EngineParamBindingValueV2[] — If array_value is set, this helps render the values
          - `label` string, required — Human readable label to be displayed for user to select
          - `literal` string — If set, this is the literal value of the step parameter
          - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter
        - `value` EngineParamBindingValueV2
          - `label` string, required — Human readable label to be displayed for user to select
          - `literal` string — If set, this is the literal value of the step parameter
          - `reference` string — If set, this is the reference into the trigger scope that is the value of this parameter

---

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