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

List all source groups

Returns a list of your team's existing source groups.

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

Query parameters

page
integer

Page number

per_page
integer

The number of sources per page (max 50)

Headers

Authorization
required string

Bearer $TOKEN

200

Response body

{
  "data": [
    {
      "id": "95251342",
      "type": "source_group",
      "attributes": {
        "id": 95251342,
        "name": "Backend sources",
        "created_at": "2025-06-30T14:00:55.700Z",
        "updated_at": "2025-06-30T14:14:40.304Z",
        "sort_index": 0,
        "team_name": "Test Team"
      }
    }
  ],
  "pagination": {
    "first": "https://telemetry.betterstack.com/api/v1/source-groups?page=1&per_page=10",
    "last": "https://telemetry.betterstack.com/api/v1/source-groups?page=12&per_page=10",
    "prev": "https://telemetry.betterstack.com/api/v1/source-groups?page=11&per_page=10",
    "next": "https://telemetry.betterstack.com/api/v1/source-groups?page=12&per_page=10"
  }
}

Example cURL

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


Previous article

Remove a metric

Next article

Get a single source group