Azure DevOps Health Event API

The Event API from Azure DevOps Health — 5 operation(s) for event.

GitHub OpenAPI

Operations 5

GET /providers/Microsoft.ResourceHealth/events/{eventTrackingId} Event get by tenant id and tracking id #
POST /providers/Microsoft.ResourceHealth/events/{eventTrackingId}/fetchEventDetails Event fetch details by tenant id and tracking id #
GET /subscriptions/{subscriptionId}/providers/Microsoft.ResourceHealth/events/{eventTrackingId} Event get by subscription id and tracking id #
POST /subscriptions/{subscriptionId}/providers/Microsoft.ResourceHealth/events/{eventTrackingId}/fetchBillingCommunicationDetails Event fetch billling communication details by subscription id and tracking id #
POST /subscriptions/{subscriptionId}/providers/Microsoft.ResourceHealth/events/{eventTrackingId}/fetchEventDetails Event fetch details by subscription id and tracking id #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/azure-devops-health:azure-devops-health-event-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

azure-devops-health-event-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Microsoft.ResourceHealth Event API
  version: '2026-07-01'
  description: The Resource Health Client.
  x-typespec-generated:
  - emitter: '@azure-tools/typespec-autorest'
servers:
- url: https://management.azure.com
security:
- azure_auth:
  - user_impersonation
tags:
- name: Event
paths:
  /providers/Microsoft.ResourceHealth/events/{eventTrackingId}:
    get:
      operationId: Event_GetByTenantIdAndTrackingId
      tags:
      - Event
      description: Service health event in the tenant by event tracking id
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - name: eventTrackingId
        in: path
        description: Event Id which uniquely identifies ServiceHealth event.
        required: true
        schema:
          type: string
      - name: $filter
        in: query
        description: The filter to apply on the operation. For more information please see https://docs.microsoft.com/en-us/rest/api/apimanagement/apis?redirectedfrom=MSDN
        required: false
        schema:
          type: string
      - name: queryStartTime
        in: query
        description: Specifies from when to return events (default is 3 days), based on the lastUpdateTime property. For example, queryStartTime = 7/24/2020 OR queryStartTime=7%2F24%2F2020
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/event'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Event get by tenant id and tracking id
      x-summary-source: derived
  /providers/Microsoft.ResourceHealth/events/{eventTrackingId}/fetchEventDetails:
    post:
      operationId: Event_fetchDetailsByTenantIdAndTrackingId
      tags:
      - Event
      description: Service health event details in the tenant by event tracking id. This can be used to fetch sensitive properties for Security Advisory events. Please see https://learn.microsoft.com/en-us/azure/service-health/security-advisories-elevated-access
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - name: eventTrackingId
        in: path
        description: Event Id which uniquely identifies ServiceHealth event.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/event'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Event fetch details by tenant id and tracking id
      x-summary-source: derived
  /subscriptions/{subscriptionId}/providers/Microsoft.ResourceHealth/events/{eventTrackingId}:
    get:
      operationId: Event_GetBySubscriptionIdAndTrackingId
      tags:
      - Event
      description: Service health event in the subscription by event tracking id
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - name: eventTrackingId
        in: path
        description: Event Id which uniquely identifies ServiceHealth event.
        required: true
        schema:
          type: string
      - name: $filter
        in: query
        description: The filter to apply on the operation. For more information please see https://docs.microsoft.com/en-us/rest/api/apimanagement/apis?redirectedfrom=MSDN
        required: false
        schema:
          type: string
      - name: queryStartTime
        in: query
        description: Specifies from when to return events (default is 3 days), based on the lastUpdateTime property. For example, queryStartTime = 7/24/2020 OR queryStartTime=7%2F24%2F2020
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/event'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Event get by subscription id and tracking id
      x-summary-source: derived
  ? /subscriptions/{subscriptionId}/providers/Microsoft.ResourceHealth/events/{eventTrackingId}/fetchBillingCommunicationDetails
  : post:
      operationId: Event_fetchBilllingCommunicationDetailsBySubscriptionIdAndTrackingId
      tags:
      - Event
      description: Service health event details specific in the subscription by event tracking id. This can be used to fetch sensitive properties for Billing event type.
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - name: eventTrackingId
        in: path
        description: Event Id which uniquely identifies ServiceHealth event.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/event'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Event fetch billling communication details by subscription id and tracking id
      x-summary-source: derived
  /subscriptions/{subscriptionId}/providers/Microsoft.ResourceHealth/events/{eventTrackingId}/fetchEventDetails:
    post:
      operationId: Event_fetchDetailsBySubscriptionIdAndTrackingId
      tags:
      - Event
      description: Service health event details in the subscription by event tracking id. This can be used to fetch sensitive properties for Security Advisory events. Please see https://learn.microsoft.com/en-us/azure/service-health/security-advisories-elevated-access
      parameters:
      - $ref: '#/components/parameters/ApiVersionParameter'
      - $ref: '#/components/parameters/SubscriptionIdParameter'
      - name: eventTrackingId
        in: path
        description: Event Id which uniquely identifies ServiceHealth event.
        required: true
        schema:
          type: string
      responses:
        '200':
          description: Azure operation completed successfully.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/event'
        default:
          description: An unexpected error response.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      summary: Event fetch details by subscription id and tracking id
      x-summary-source: derived
components:
  schemas:
    LevelValues:
      type: string
      description: Level of insight.
      enum:
      - Critical
      - Warning
      x-ms-enum:
        name: LevelValues
        modelAsString: true
        values:
        - name: Critical
          value: Critical
          description: Critical
        - name: Warning
          value: Warning
          description: Warning
    faq:
      type: object
      description: Frequently asked question for the service health event
      properties:
        question:
          type: string
          description: FAQ question for the service health event.
        answer:
          type: string
          description: FAQ answer for the service health event.
        localeCode:
          type: string
          description: FAQ locale for the service health event.
    EventPropertiesRecommendedActionsActionsItem:
      type: object
      description: Recommended action for the service health event.
      properties:
        groupId:
          type: integer
          format: int32
          description: Recommended action group Id for the service health event.
        actionText:
          type: string
          description: Recommended action text
    EventPropertiesRecommendedActions:
      type: object
      description: Recommended actions of event.
      properties:
        message:
          type: string
          description: Recommended action title for the service health event.
        actions:
          type: array
          description: Recommended actions for the service health event.
          items:
            $ref: '#/components/schemas/EventPropertiesRecommendedActionsActionsItem'
          x-ms-identifiers: []
        localeCode:
          type: string
          description: Recommended action locale for the service health event.
    EventSourceValues:
      type: string
      description: Source of event.
      enum:
      - ResourceHealth
      - ServiceHealth
      x-ms-enum:
        name: EventSourceValues
        modelAsString: true
        values:
        - name: ResourceHealth
          value: ResourceHealth
          description: ResourceHealth
        - name: ServiceHealth
          value: ServiceHealth
          description: ServiceHealth
    link:
      type: object
      description: Useful links for service health event.
      properties:
        type:
          $ref: '#/components/schemas/LinkTypeValues'
          description: Type of link.
        displayText:
          $ref: '#/components/schemas/LinkDisplayText'
          description: Display text of link.
        extensionName:
          type: string
          description: It provides the name of portal extension to produce link for given service health event.
        bladeName:
          type: string
          description: It provides the name of portal extension blade to produce link for given service health event.
        parameters:
          description: It provides a map of parameter name and value for portal extension blade to produce lik for given service health event.
    LinkTypeValues:
      type: string
      description: Type of link.
      enum:
      - Button
      - Hyperlink
      x-ms-enum:
        name: LinkTypeValues
        modelAsString: true
        values:
        - name: Button
          value: Button
          description: Button
        - name: Hyperlink
          value: Hyperlink
          description: Hyperlink
    EventPropertiesArticle:
      type: object
      description: Article of event.
      properties:
        articleContent:
          type: string
          description: Article content of event.
        articleId:
          type: string
          description: Article Id
        parameters:
          description: It provides a map of parameter name and value
    update:
      type: object
      description: Update for service health event.
      properties:
        summary:
          type: string
          description: Summary text for the given update for the service health event.
        updateDateTime:
          type: string
          format: date-time
          description: It provides the Timestamp for the given update for the service health event.
        eventTags:
          type: array
          description: 'A list of metadata tags associated with the event. Possible values include:

            -Action Recommended: Action may be required by you to avoid possible disruptions or mitigate risks for your services. It is recommended to evaluate these actions and the potential impact on your services.

            - False Positive: After investigation, we''ve determined your service is healthy and service issues did not impact your services as originally communicated.

            - Preliminary PIR: For our largest, most impactful service issues a Preliminary Post Incident Review (PIR) is published generally within 72 hours of mitigation, to summarize what we have learned so far from the still-in-progress investigation.

            - Final PIR: For service issues, a Final Post Incident Review (PIR) may be published to provide additional details or learnings. Sometimes this requires us to complete an internal retrospective, generally within 14 days of mitigation.'
          items:
            type: string
    EventLevelValues:
      type: string
      description: Level of event.
      enum:
      - Critical
      - Error
      - Warning
      - Informational
      x-ms-enum:
        name: EventLevelValues
        modelAsString: true
        values:
        - name: Critical
          value: Critical
          description: Critical
        - name: Error
          value: Error
          description: Error
        - name: Warning
          value: Warning
          description: Warning
        - name: Informational
          value: Informational
          description: Informational
    impact:
      type: object
      description: Azure service impacted by the service health event.
      properties:
        impactedService:
          type: string
          description: Impacted service name.
        impactedServiceGuid:
          type: string
          description: Impacted service guid. This is the permanent identifier for the impacted service.
        impactedRegions:
          type: array
          description: List regions impacted by the service health event.
          items:
            $ref: '#/components/schemas/impactedServiceRegion'
          x-ms-identifiers: []
    ApiOperationLink:
      type: object
      description: An API operation associated with an event.
      properties:
        httpMethod:
          type: string
          description: HTTP method to use. Resource Health returns GET for Advisor recommendations.
          readOnly: true
        url:
          type: string
          format: uri
          description: Opaque absolute ARM URL for the associated API operation.
          readOnly: true
        description:
          type: string
          description: Human-readable description of the operation. Clients must not parse this value.
          readOnly: true
      required:
      - httpMethod
      - url
    EventProperties:
      type: object
      description: Properties of event.
      properties:
        eventType:
          $ref: '#/components/schemas/EventTypeValues'
          description: Type of event.
        eventSubType:
          $ref: '#/components/schemas/EventSubTypeValues'
          description: Sub-type of event.
        advisorRecommendations:
          $ref: '#/components/schemas/ApiOperationLink'
          description: Operation for listing Advisor recommendations associated with this event's tracking ID in the response subscription.
          readOnly: true
        eventSource:
          $ref: '#/components/schemas/EventSourceValues'
          description: Source of event.
        status:
          $ref: '#/components/schemas/EventStatusValues'
          description: Current status of event.
        title:
          type: string
          description: Title text of event.
        summary:
          type: string
          description: Summary text of event. Use fetchEventDetails endpoint to get summary of sensitive events.
        header:
          type: string
          description: Header text of event.
        level:
          $ref: '#/components/schemas/LevelValues'
          description: Level of insight.
        eventLevel:
          $ref: '#/components/schemas/EventLevelValues'
          description: Level of event.
        isEventSensitive:
          type: boolean
          description: If true the event may contains sensitive data. Use the post events/{trackingId}/fetchEventDetails endpoint to fetch sensitive data see https://learn.microsoft.com/en-us/azure/service-health/security-advisories-elevated-access
        externalIncidentId:
          type: string
          description: The id of the Incident
        reason:
          type: string
          description: The reason for the Incident
        article:
          $ref: '#/components/schemas/EventPropertiesArticle'
          description: Article of event.
        links:
          type: array
          description: Useful links of event.
          items:
            $ref: '#/components/schemas/link'
          x-ms-identifiers: []
        impactStartTime:
          type: string
          format: date-time
          description: It provides the Timestamp for when the health impacting event started.
        impactMitigationTime:
          type: string
          format: date-time
          description: It provides the Timestamp for when the health impacting event resolved.
        impact:
          type: array
          description: List services impacted by the service health event.
          items:
            $ref: '#/components/schemas/impact'
          x-ms-identifiers: []
        recommendedActions:
          $ref: '#/components/schemas/EventPropertiesRecommendedActions'
          description: Recommended actions of event.
        faqs:
          type: array
          description: Frequently asked questions for the service health event.
          items:
            $ref: '#/components/schemas/faq'
          x-ms-identifiers: []
        isHIR:
          type: boolean
          description: It provides information if the event is High incident rate event or not.
        enableMicrosoftSupport:
          type: boolean
          description: Tells if we want to enable or disable Microsoft Support for this event.
        description:
          type: string
          description: Contains the communication message for the event, that could include summary, root cause and other details. Use fetchEventDetails endpoint to get description of sensitive events.
        platformInitiated:
          type: boolean
          description: Is true if the event is platform initiated.
        enableChatWithUs:
          type: boolean
          description: Tells if we want to enable or disable Microsoft Support for this event.
        priority:
          type: integer
          format: int32
          description: Priority level of the event. Has value from 0 to 23. 0 is the highest priority. Service issue events have higher priority followed by planned maintenance and health advisory. Critical events have higher priority followed by error, warning and informational. Furthermore, active events have higher priority than resolved.
        lastUpdateTime:
          type: string
          format: date-time
          description: It provides the Timestamp for when the health impacting event was last updated.
        hirStage:
          type: string
          description: Stage for HIR Document
        additionalInformation:
          $ref: '#/components/schemas/EventPropertiesAdditionalInformation'
          description: Additional information
        duration:
          type: integer
          format: int32
          description: duration in seconds
        impactType:
          type: string
          description: The type of the impact
        eventTags:
          type: array
          description: 'A list of metadata tags associated with the event. Possible values include:

            -Action Recommended: Action may be required by you to avoid possible disruptions or mitigate risks for your services. It is recommended to evaluate these actions and the potential impact on your services.

            - False Positive: After investigation, we''ve determined your service is healthy and service issues did not impact your services as originally communicated.

            - Preliminary PIR: For our largest, most impactful service issues a Preliminary Post Incident Review (PIR) is published generally within 72 hours of mitigation, to summarize what we have learned so far from the still-in-progress investigation.

            - Final PIR: For service issues, a Final Post Incident Review (PIR) may be published to provide additional details or learnings. Sometimes this requires us to complete an internal retrospective, generally within 14 days of mitigation.'
          items:
            type: string
        newRate:
          type: number
          format: double
          description: Billing rate change information - new rate
        oldRate:
          type: number
          format: double
          description: Billing rate change information - old rate
        currencyType:
          type: string
          description: 'Billing currency type information. Example: USD, CAD'
        billingId:
          type: string
          description: Billing identifier information.
    TypesProxyResource:
      type: object
      title: Proxy Resource
      description: The resource model definition for a Azure Resource Manager proxy resource. It will not have tags and a location
      allOf:
      - $ref: '#/components/schemas/Resource'
    ErrorResponse:
      type: object
      description: Error details.
      properties:
        code:
          type: string
          description: The error code.
          readOnly: true
        message:
          type: string
          description: The error message.
          readOnly: true
        details:
          type: string
          description: The error details.
          readOnly: true
    event:
      type: object
      description: Service health event
      properties:
        properties:
          $ref: '#/components/schemas/EventProperties'
          description: Properties of event.
          x-ms-client-flatten: true
      allOf:
      - $ref: '#/components/schemas/TypesProxyResource'
    LinkDisplayText:
      type: object
      description: Display text of link.
      properties:
        value:
          type: string
          description: Display text of link.
        localizedValue:
          type: string
          description: Localized display text of link.
    impactedServiceRegion:
      type: object
      description: Azure region impacted by the service health event.
      properties:
        impactedRegion:
          type: string
          description: Impacted region name.
        status:
          $ref: '#/components/schemas/EventStatusValues'
          description: Current status of event in the region.
        impactedSubscriptions:
          type: array
          description: List subscription impacted by the service health event.
          items:
            type: string
        impactedTenants:
          type: array
          description: List tenant impacted by the service health event.
          items:
            type: string
        lastUpdateTime:
          type: string
          format: date-time
          description: It provides the Timestamp for when the last update for the service health event.
        updates:
          type: array
          description: List of updates for given service health event.  Use fetchEventDetails endpoint to get updates of sensitive events.
          items:
            $ref: '#/components/schemas/update'
          x-ms-identifiers: []
    EventSubTypeValues:
      type: string
      description: Sub-type of event.
      enum:
      - Retirement
      - ForeignExchangeRateChange
      - Underbilling
      - Overbilling
      - PriceChanges
      - TaxChanges
      - MeterIDChanges
      - UnauthorizedPartyAbuse
      x-ms-enum:
        name: EventSubTypeValues
        modelAsString: true
        values:
        - name: Retirement
          value: Retirement
          description: Retirement
        - name: ForeignExchangeRateChange
          value: ForeignExchangeRateChange
          description: ForeignExchangeRateChange
        - name: Underbilling
          value: Underbilling
          description: Underbilling
        - name: Overbilling
          value: Overbilling
          description: Overbilling
        - name: PriceChanges
          value: PriceChanges
          description: PriceChanges
        - name: TaxChanges
          value: TaxChanges
          description: TaxChanges
        - name: MeterIDChanges
          value: MeterIDChanges
          description: MeterIDChanges
        - name: UnauthorizedPartyAbuse
          value: UnauthorizedPartyAbuse
          description: UnauthorizedPartyAbuse
    EventTypeValues:
      type: string
      description: Type of event.
      enum:
      - ServiceIssue
      - PlannedMaintenance
      - HealthAdvisory
      - RCA
      - EmergingIssues
      - SecurityAdvisory
      - Billing
      x-ms-enum:
        name: EventTypeValues
        modelAsString: true
        values:
        - name: ServiceIssue
          value: ServiceIssue
          description: ServiceIssue
        - name: PlannedMaintenance
          value: PlannedMaintenance
          description: PlannedMaintenance
        - name: HealthAdvisory
          value: HealthAdvisory
          description: HealthAdvisory
        - name: RCA
          value: RCA
          description: RCA
        - name: EmergingIssues
          value: EmergingIssues
          description: EmergingIssues
        - name: SecurityAdvisory
          value: SecurityAdvisory
          description: SecurityAdvisory
        - name: Billing
          value: Billing
          description: Billing
    EventStatusValues:
      type: string
      description: Current status of event.
      enum:
      - Active
      - Resolved
      x-ms-enum:
        name: EventStatusValues
        modelAsString: true
        values:
        - name: Active
          value: Active
          description: Active
        - name: Resolved
          value: Resolved
          description: Resolved
    EventPropertiesAdditionalInformation:
      type: object
      description: Additional information
      properties:
        message:
          type: string
          description: Additional information Message
  parameters:
    SubscriptionIdParameter:
      name: subscriptionId
      in: path
      description: The ID of the target subscription.
      required: true
      schema:
        type: string
        minLength: 1
    ApiVersionParameter:
      name: api-version
      in: query
      description: The API version to use for this operation.
      required: true
      schema:
        type: string
        minLength: 1
  securitySchemes:
    azure_auth:
      type: oauth2
      flows:
        implicit:
          scopes:
            user_impersonation: impersonate your user account
          authorizationUrl: https://login.microsoftonline.com/common/oauth2/authorize
      description: Azure Active Directory OAuth2 Flow.