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

# List active provider impact advisories

> Services the organization tracks that publish a dependency on an infrastructure provider currently reporting an incident. Advisories are derived from confirmed dependency links at alerting impact tiers and are computed live, so one disappears when the provider recovers rather than being retracted. An advisory is a hedge, never a confirmed outage at the named service — that service's own status remains authoritative.




## OpenAPI

````yaml /openapi/api-docs.yaml get /v1/provider-impact
openapi: 3.0.3
info:
  title: StatusStack API
  description: >
    API for managing status monitoring, incidents, stacks, and website
    monitoring.


    You can import this specification directly into Postman, Insomnia or any
    other

    OpenAPI-compatible client.


    Only the operations documented here are part of the supported public API.
    Any other

    endpoint is unstable and may change without a version bump.
  version: 1.4.0
  contact:
    name: StatusStack Support
    url: https://statusstack.com/support
servers:
  - url: https://statusstack.com/api
    description: Production server
security: []
paths:
  /v1/provider-impact:
    get:
      summary: List active provider impact advisories
      description: >
        Services the organization tracks that publish a dependency on an
        infrastructure provider currently reporting an incident. Advisories are
        derived from confirmed dependency links at alerting impact tiers and are
        computed live, so one disappears when the provider recovers rather than
        being retracted. An advisory is a hedge, never a confirmed outage at the
        named service — that service's own status remains authoritative.
      responses:
        '200':
          description: Advisories currently overlaying the organization's tracked services
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      $ref: '#/components/schemas/ProviderImpactAdvisory'
                  meta:
                    type: object
                    properties:
                      count:
                        type: integer
                      advisory:
                        type: boolean
                        description: >-
                          Always true; marks the payload as an overlay rather
                          than observed status.
        '401':
          description: Missing, revoked or expired API key
        '403':
          description: >-
            No organization scope available for this request, or the tenant has
            no paid API entitlement
        '404':
          description: Provider impact advisories are not enabled
      security:
        - bearerAuth: []
components:
  schemas:
    ProviderImpactAdvisory:
      type: object
      properties:
        vendor:
          type: object
          description: The tracked service that may be affected.
          properties:
            id:
              type: string
              format: uuid
            name:
              type: string
            key:
              type: string
              nullable: true
            logo_url:
              type: string
              nullable: true
        provider:
          type: object
          description: The infrastructure provider currently reporting an incident.
          properties:
            id:
              type: string
              format: uuid
            name:
              type: string
            key:
              type: string
              nullable: true
            status:
              type: string
              nullable: true
        impact_tier:
          type: string
          enum:
            - runtime
            - supporting
          description: >
            How visible an outage at the provider would be to the vendor's own
            users. Only runtime and supporting can raise an advisory;
            back_office and unknown never do.
        relationship:
          type: string
          description: What the provider does for the vendor, e.g. hosting, cdn, dns.
        stated_purpose:
          type: string
          nullable: true
          description: The purpose the vendor published for this subprocessor, verbatim.
        evidence_url:
          type: string
          nullable: true
          description: The vendor's own trust center page that made the claim.
        incident:
          type: object
          properties:
            id:
              type: string
              nullable: true
            title:
              type: string
              nullable: true
            url:
              type: string
              nullable: true
            started_at:
              type: string
              format: date-time
              nullable: true
        headline:
          type: string
          description: Hedged, tier-specific one-line summary.
        attribution:
          type: string
          description: The citation behind the claim, in one sentence.
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >
        StatusStack authenticates requests with API keys, created via the
        dashboard with

        granular permissions (read, write, delete, admin, *).


        API keys support version compatibility:

        - v1 keys: Can only access v1 endpoints

        - v2 keys: Can access both v1 and v2 endpoints


        Available permissions:

        - `read`: View resources (GET requests)

        - `write`: Create and update resources (POST, PUT requests)

        - `delete`: Delete resources (DELETE requests)

        - `admin`: Administrative access to all resources

        - `*`: Wildcard permission (all actions allowed)

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.