Get a single team

Returns a single team by its 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/{id}

URL parameters

id
required string

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
    }
  }
}
401

Response body

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

Response body

{
  "errors": "Resource type team with id = t123 was not found"
}

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

Example cURL

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