List all teams

Lists all teams in your organization, ordered by ID. Needs a global API token or a signed-in user's OAuth token, which reads only the teams the user belongs to.

GET https://betterstack.com/api/v2/teams

Query parameters

page
integer
per_page
integer

Headers

Authorization
required string
200

Response body

{
  "data": [
    {
      "id": "t123",
      "type": "team",
      "attributes": {
        "name": "Platform team",
        "created_at": "2026-11-16T09:00:00.000Z",
        "updated_at": "2026-11-16T09:00:00.000Z",
        "incident_grouping_period": 300,
        "incident_grouping_metadata_scope": [
          "Origin"
        ],
        "notify_about_all_incidents_in_a_group": true,
        "reporting_enabled": false,
        "opened_emails_tracking_enabled": true,
        "on_call_reminder_lead_time": 86400,
        "on_call_reminder_sms": false,
        "on_call_reminder_email": true,
        "on_call_reminder_push": true
      }
    }
  ],
  "pagination": {
    "first": "https://betterstack.com/api/v2/teams?page=1",
    "last": "https://betterstack.com/api/v2/teams?page=1",
    "prev": null,
    "next": null
  }
}
401

Response body

{
  "errors": "We could not authenticate your request. Please provide a valid Global API token or Better Stack OAuth token."
}

Response attributes

id
string
type
string
attributes.name
string
attributes.created_at
string
attributes.updated_at
string
attributes.incident_grouping_period
integer
attributes.incident_grouping_metadata_scope
array or null
attributes.notify_about_all_incidents_in_a_group
boolean
attributes.reporting_enabled
boolean
attributes.opened_emails_tracking_enabled
boolean
attributes.on_call_reminder_lead_time
integer
attributes.on_call_reminder_sms
boolean
attributes.on_call_reminder_email
boolean
attributes.on_call_reminder_push
boolean
pagination.first
string
pagination.last
string
pagination.prev
string or null
pagination.next
string or null

Example cURL

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