--- title: "List degradations" method: GET path: "/api/v2/statuspages/degradations" tags: ["Status Pages"] --- # List degradations `GET /api/v2/statuspages/degradations` Lists all degradations for the organization. Optionally filter by status and page. ## Query parameters - `filter[page_id]` string - `page[offset]` integer - `page[limit]` integer - `include` string - `filter[status]` string - `sort` string ## Response `200` OK - DegradationArray — Response object for a list of degradations. - `data` DegradationData[], required — A list of degradation data objects. - `attributes` DegradationDataAttributes — The attributes of a degradation. - `components_affected` DegradationDataAttributesComponentsAffectedItems[] — Components affected by the degradation. - `id` string, uuid, required — The ID of the component. - `name` string — The name of the component. - `status` 'operational' | 'degraded' | 'partial_outage' | 'major_outage' | 'maintenance', required — The status of the component. - `created_at` string, date-time — Timestamp of when the degradation was created. - `description` string — Description of the degradation. - `is_backfilled` boolean — Whether the degradation was backfilled. - `modified_at` string, date-time — Timestamp of when the degradation was last modified. - `source` DegradationDataAttributesSource — The source of the degradation. - `created_at` string, date-time, required — Timestamp of when the source was created. - `source_id` string, required — The ID of the source. - `type` 'incident', required — The type of the source. - `status` 'investigating' | 'identified' | 'monitoring' | 'resolved' — The status of the degradation. - `title` string — Title of the degradation. - `updates` DegradationDataAttributesUpdatesItems[] — Past updates made to the degradation. - `components_affected` DegradationDataAttributesUpdatesItemsComponentsAffectedItems[] — The components affected at the time of the update. - `id` string, uuid, required — Identifier of the component affected at the time of the update. - `name` string — The name of the component affected at the time of the update. - `status` 'operational' | 'degraded' | 'partial_outage' | 'major_outage' | 'maintenance', required — The status of the component. - `created_at` string, date-time — Timestamp of when the update was created. - `deleted_at` string — The date and time the resource was deleted. - `deleted_by_user_uuid` string — UUID of the user who deleted the resource. - `description` string — Description of the update. - `id` string, uuid — Identifier of the update. - `last_modified_by_user_uuid` string — UUID of the user who last modified the resource. - `modified_at` string, date-time — Timestamp of when the update was last modified. - `started_at` string, date-time — Timestamp of when the update started. - `status` 'investigating' | 'identified' | 'monitoring' | 'resolved' — The status of the degradation. - `id` string, uuid — The ID of the degradation. - `relationships` DegradationDataRelationships — The relationships of a degradation. - `created_by_user` DegradationDataRelationshipsCreatedByUser — The Datadog user who created the degradation. - `data` DegradationDataRelationshipsCreatedByUserData, required — The data object identifying the Datadog user who created the degradation. - `id` string, required — The ID of the Datadog user who created the degradation. - `type` 'users', required — Users resource type. - `last_modified_by_user` DegradationDataRelationshipsLastModifiedByUser — The Datadog user who last modified the degradation. - `data` DegradationDataRelationshipsLastModifiedByUserData, required — The data object identifying the Datadog user who last modified the degradation. - `id` string, required — The ID of the Datadog user who last modified the degradation. - `type` 'users', required — Users resource type. - `status_page` DegradationDataRelationshipsStatusPage — The status page the degradation belongs to. - `data` DegradationDataRelationshipsStatusPageData, required — The data object identifying the status page the degradation belongs to. - `id` string, uuid, required — The ID of the status page. - `type` 'status_pages', required — Status pages resource type. - `type` 'degradations', required — Degradations resource type. - `included` DegradationIncluded[] — The included related resources of a degradation. Client must explicitly request these resources by name in the `include` query parameter. - union — An included resource related to a degradation or maintenance. - StatusPagesUser — The included Datadog user resource. - `attributes` StatusPagesUserAttributes — Attributes of the Datadog user. - `email` string — The email of the Datadog user. - `handle` string — The handle of the Datadog user. - `icon` string — The icon of the Datadog user. - `name` string — The name of the Datadog user. - `uuid` string — The UUID of the Datadog user. - `id` string, uuid — The ID of the Datadog user. - `type` 'users', required — Users resource type. - StatusPageAsIncluded — The included status page resource. - `attributes` StatusPageAsIncludedAttributes — The attributes of a status page. - `company_logo` string — The base64-encoded image data displayed in the company logo. - `components` StatusPageAsIncludedAttributesComponentsItems[] — Components displayed on the status page. - `components` StatusPageAsIncludedAttributesComponentsItemsComponentsItems[] — If the component is of type `group`, the components within the group. - … - `id` string, uuid — The ID of the component. - `name` string — The name of the component. - `position` integer — The zero-indexed position of the component. - `status` 'operational' | 'degraded' | 'partial_outage' | 'major_outage' | 'maintenance' — The status of the component. - `type` 'component' | 'group' — The type of the component. - `created_at` string, date-time — Timestamp of when the status page was created. - `custom_domain` string — If configured, the url that the status page is accessible at. - `custom_domain_enabled` boolean — Whether the custom domain is configured. - `domain_prefix` string — The subdomain of the status page's url taking the form `https://{domain_prefix}.statuspage.datadoghq.com`. Globally unique across Datadog Status Pages. - `email_header_image` string — Base64-encoded image data included in email notifications sent to status page subscribers. - `enabled` boolean — Whether the status page is enabled. - `favicon` string — Base64-encoded image data displayed in the browser tab. - `modified_at` string, date-time — Timestamp of when the status page was last modified. - `name` string — The name of the status page. - `page_url` string — The url that the status page is accessible at. - `slack_app_icon` string — The Slack app icon URL for the status page. - `slack_subscriptions_enabled` boolean — Whether Slack subscriptions are enabled for the status page. - `subscriptions_enabled` boolean — Whether users can subscribe to the status page. - `type` 'public' | 'internal' — The type of the status page controlling how the status page is accessed. - `visualization_type` 'bars_and_uptime_percentage' | 'bars_only' | 'component_name_only' — The visualization type of the status page. - `id` string, uuid — The ID of the status page. - `relationships` StatusPageAsIncludedRelationships — The relationships of a status page. - `created_by_user` StatusPageAsIncludedRelationshipsCreatedByUser — The Datadog user who created the status page. - `data` StatusPageAsIncludedRelationshipsCreatedByUserData, required — The data object identifying the Datadog user who created the status page. - … - `last_modified_by_user` StatusPageAsIncludedRelationshipsLastModifiedByUser — The Datadog user who last modified the status page. - `data` StatusPageAsIncludedRelationshipsLastModifiedByUserData, required — The data object identifying the Datadog user who last modified the status page. - … - `type` 'status_pages', required — Status pages resource type. - `meta` PaginationMeta — Response metadata. - `page` PaginationMetaPage — Offset-based pagination schema. - `first_offset` integer — Integer representing the offset to fetch the first page of results. - `last_offset` integer, nullable — Integer representing the offset to fetch the last page of results. - `limit` integer — Integer representing the number of elements to be returned in the results. - `next_offset` integer, nullable — Integer representing the index of the first element in the next page of results. Equal to page size added to the current offset. - `offset` integer — Integer representing the index of the first element in the results. - `prev_offset` integer, nullable — Integer representing the index of the first element in the previous page of results. - `total` integer, nullable — Integer representing the total number of elements available. - `type` 'offset_limit' — The pagination type used for offset-based pagination. ## Other responses - `429` — Too many requests --- [API](https://skmtc.net/datadog/apis/api-v2.md) · [All operations](https://skmtc.net/datadog/apis/api-v2/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/datadog/api-v2/revisions/da68bf029e4c/schema)