Get team maintenance

Returns whether a team is in team-wide maintenance and when it ends. An Incidents API token acts on its own team. With a global API token, pick the team with team_name or team_id.

GET https://incidents.betterstack.com/api/v2/team-maintenance

Query parameters

team_name
string
team_id
string

Headers

Authorization
required string
200

Response body

{
  "data": {
    "id": "t123",
    "type": "team_maintenance",
    "attributes": {
      "team_name": "Platform team",
      "maintenance": true,
      "maintenance_to": "2026-11-16T18:30:00Z"
    }
  }
}
200

Response body

{
  "data": {
    "id": "t123",
    "type": "team_maintenance",
    "attributes": {
      "team_name": "Platform team",
      "maintenance": false,
      "maintenance_to": null
    }
  }
}
401

Response body

{
  "errors": "Invalid Team API token. How to find your Team API token: https://betterstack.com/docs/uptime/api/getting-started-with-uptime-api/#get-an-incidents-api-token"
}
422

Response body

{
  "errors": "This token has access to multiple teams. Please use `team_name` or `better_stack_team_id` to specify the team"
}

Response attributes

id
string
type
string
attributes.team_name
string
attributes.maintenance
boolean
attributes.maintenance_to
string or null

Example cURL

Example
curl --request GET \
  --url https://incidents.betterstack.com/api/v2/team-maintenance \
  --header "Authorization: Bearer $TOKEN"