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

# Get an incident's live escalation state

> The policy in effect (the monitor's own, else the workspace default), each ladder step, which steps have already paged (and via what delivery), and whether the incident has been acknowledged.



## OpenAPI

````yaml https://www.sentivel.com/api/v1/openapi.json get /incidents/{id}/escalation
openapi: 3.1.0
info:
  title: Sentivel API
  version: 1.0.0
  description: >-
    Provision and read your Sentivel workspace programmatically: components,
    monitors, status pages and incidents. Authenticate with an org API token
    (create one under Developers → API tokens in the dashboard).
  contact:
    name: Sentivel
    url: https://www.sentivel.com
servers:
  - url: https://www.sentivel.com/api/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: Identity
    description: Who the token is
  - name: Components
    description: Status-page components (status units)
  - name: Monitors
    description: Uptime/HTTP checks
  - name: Status pages
    description: Public status pages
  - name: Incidents
    description: Incidents (read + manual create)
  - name: People
    description: Workspace members
  - name: Integrations
    description: Outbound alert destinations
  - name: On-call
    description: On-call schedules
paths:
  /incidents/{id}/escalation:
    get:
      tags:
        - Incidents
      summary: Get an incident's live escalation state
      description: >-
        The policy in effect (the monitor's own, else the workspace default),
        each ladder step, which steps have already paged (and via what
        delivery), and whether the incident has been acknowledged.
      operationId: getIncidentEscalation
      parameters:
        - name: id
          in: path
          required: true
          schema:
            type: string
            format: uuid
      responses:
        '200':
          description: The incident's escalation state.
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    $ref: '#/components/schemas/IncidentEscalation'
        '404':
          description: No such incident.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
components:
  schemas:
    IncidentEscalation:
      type: object
      properties:
        incidentId:
          type: string
          format: uuid
        status:
          type: string
        acknowledgedAt:
          type:
            - string
            - 'null'
          format: date-time
        resolvedAt:
          type:
            - string
            - 'null'
          format: date-time
        escalating:
          type: boolean
          description: True while escalation is still active (open + unacknowledged).
        elapsedMinutes:
          type: integer
        policy:
          type:
            - object
            - 'null'
          properties:
            id:
              type: string
              format: uuid
            name:
              type: string
            repeatCount:
              type: integer
            silent:
              type: boolean
              description: >-
                Silent triage policy: records incidents but pages no one (no
                steps fire).
            runbook:
              type:
                - string
                - 'null'
              description: >-
                The policy's responder runbook (markdown checklist/playbook), or
                null if none.
        steps:
          type: array
          items:
            type: object
            properties:
              stepId:
                type: string
                format: uuid
              position:
                type: integer
              delayMinutes:
                type: integer
              minImpact:
                type: string
              due:
                type: boolean
              fired:
                type: boolean
              firedAt:
                type:
                  - string
                  - 'null'
                format: date-time
              deliveries:
                type: array
                items:
                  type: object
                  properties:
                    channel:
                      type: string
                    target:
                      type: string
                    status:
                      type: string
                    sentAt:
                      type:
                        - string
                        - 'null'
                      format: date-time
        note:
          type: string
          description: Present when no ladder applies (no policy).
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
              enum:
                - unauthorized
                - forbidden
                - not_found
                - invalid_request
                - rate_limited
                - conflict
                - internal
            message:
              type: string
            details:
              type: object
          required:
            - code
            - message
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: 'An org API token (`sv_…`), sent as `Authorization: Bearer <token>`.'

````