Explore documentation
  1. Welcome to Uptime 👋
  2. Frequently Asked Questions
  3. On-call scheduling and alerting
    1. Get started
    2. Slack and other integrations ↗
    3. Connecting external calendars
    4. Advanced guide
  4. Incidents
    1. Get started
    2. Advanced guide
    3. Reporting ↗
  5. Monitoring
    1. Get started
    2. Working with monitors
    3. Customizing monitors
    4. Monitor types
  6. Status pages
    1. Get started
    2. Advanced guide
  7. Uptime API
    1. Getting an API token
    2. Monitors
      1. Monitors API
      2. Monitor groups API
        1. List monitor groups GET
        2. Get monitor group GET
        3. List monitors in group GET
        4. Create monitor group POST
        5. Update monitor group PATCH
        6. Remove monitor group DELETE
        7. Response attributes
    3. Heartbeats
    4. On-call & incidents
    5. Status pages
    6. Metadata
    7. Integrations

List monitor groups

Returns a list of all your monitor groups. This endpoint supports pagination.

GET https://uptime.betterstack.com/api/v2/monitor-groups

Query parameters

team_name
string

Filter monitor groups belonging to a specified team when using global API token.

Headers

Authorization
required string

Bearer $TOKEN

200

Returns list of existing monitor groups

Response body

{
  "data": [
    {
      "id": "95251342",
      "type": "monitor_group",
      "attributes": {
        "name": "Backend services",
        "sort_index": null,
        "created_at": "2020-10-03T20:20:43.547Z",
        "updated_at": "2020-10-03T20:20:43.547Z",
        "team_name": "Test team",
        "paused": true
      }
    }
  ],
  "pagination": {
    "first": "https://uptime.betterstack.com/api/v2/monitor-groups?page=1",
    "last": "https://uptime.betterstack.com/api/v2/monitor-groups?page=1",
    "prev": null,
    "next": null
  }
}

Example cURL

Example
curl --request GET \
  --url https://uptime.betterstack.com/api/v2/monitor-groups \
  --header "Authorization: Bearer $TOKEN"


Previous article

Response attributes

Next article

Get monitor group