Explore documentation
  1. Welcome to Telemetry 👋
  2. Quick start guide
  3. Wide events vs. metrics
  4. Ingesting data
    1. Better Stack collector
    2. OpenTelemetry
    3. Vector
    4. Ingesting via HTTP API
    5. Ingesting metrics
    6. Ingesting logs
    7. Migrating to Better Stack
  5. Using the product
    1. AI SRE ↗
    2. MCP server ↗
    3. Transforming ingested data
    4. Querying data
    5. Tracing
    6. Grafana
    7. Alerts
  6. Telemetry API
    1. Getting an API token
    2. Sources & collectors
      1. Sources API
      2. Collectors API
      3. Collector metrics targets API
      4. Metrics API
      5. Source groups API
        1. List all source groups GET
        2. Get a single source group GET
        3. List sources in group GET
        4. Create a source group GET
        5. Update a source group PATCH
        6. Remove a source group DELETE
    3. Dashboards
    4. Explorations
    5. Alerts API
    6. Connections API
    7. Query API ↗
    8. Usage API ↗
  7. Alternative to
    1. Lightstep

Get a single source group

Get a single source group by its ID.

GET https://telemetry.betterstack.com/api/v1/source-groups/{id}

URL parameters

id
required string

The ID of the source group you want to get

Headers

Authorization
required string

Bearer $TOKEN

200

Returns the source group.

Response body

{
  "data": {
    "id": "95251342",
    "type": "source_group",
    "attributes": {
      "name": "Backend sources",
      "created_at": "2025-06-30T17:43:12.192Z",
      "updated_at": "2025-06-30T17:43:12.192Z",
      "sort_index": null,
      "team_name": "Test team"
    }
  }
}
404

Your team doesn't have a source group with this ID

Response body

{
  "errors": "Resource with provided ID was not found"
}

Response attributes

id
string

The ID of the source group.

type
string

The resource type, always source_group.

attributes.name
string

The name of the source group.

attributes.created_at
string

When the source group was created, as an ISO 8601 date-time in UTC.

attributes.updated_at
string

When the source group was last updated, as an ISO 8601 date-time in UTC.

attributes.sort_index
integer

The position of the source group when sorting groups, or null when none is set.

attributes.team_name
string

The name of the team that owns the source group.

Example cURL

Example
curl --request GET \
  --url https://telemetry.betterstack.com/api/v1/source-groups/123 \
  --header "Authorization: Bearer $TOKEN"


Previous article

List all source groups

Next article

List sources in a source group