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 sources in a source group

Returns a list of all sources in a specific source group.

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

URL parameters

id
required string

The ID of the source group.

Query parameters

page
integer

Page number

per_page
integer

Number of sources per page. Default 50, maximum 250.

Headers

Authorization
required string

Bearer $TOKEN

200

Returns a paginated list of sources in the source group.

Response body

{
  "data": [
    {
      "id": "101",
      "type": "source",
      "attributes": {
        "source_group_id": 95251342,
        "team_id": 123,
        "team_name": "Test team",
        "name": "Production API Server",
        "platform": "ruby",
        "table_name": "prod_api",
        "token": "abcDefGhiJklMnoPqrStuVwx",
        "ingesting_paused": false,
        "ingesting_host": "s101.eu-nbg-2.betterstackdata.com",
        "created_at": "2026-10-26T10:00:00.000Z",
        "updated_at": "2026-10-26T10:00:00.000Z",
        "retention": 30,
        "logs_retention": 30,
        "metrics_retention": 30,
        "live_tail_pattern": null,
        "data_region": "eu-nbg-2",
        "custom_bucket": null,
        "vrl_transformation": "",
        "vrl_transformation_logs": "",
        "vrl_transformation_spans": "",
        "blocked_metrics": []
      }
    },
    {
      "id": "102",
      "type": "source",
      "attributes": {
        "source_group_id": 95251342,
        "team_id": 123,
        "team_name": "Test team",
        "name": "Staging Database",
        "platform": "postgresql",
        "table_name": "staging_db",
        "token": "yzaBcDefGhiJklMnoPqrStuV",
        "ingesting_paused": true,
        "ingesting_host": "s102.eu-nbg-2.betterstackdata.com",
        "created_at": "2026-10-25T12:00:00.000Z",
        "updated_at": "2026-10-25T12:00:00.000Z",
        "retention": 7,
        "logs_retention": 7,
        "metrics_retention": 7,
        "live_tail_pattern": null,
        "data_region": "eu-nbg-2",
        "custom_bucket": null,
        "vrl_transformation": "",
        "vrl_transformation_logs": "",
        "vrl_transformation_spans": "",
        "blocked_metrics": []
      }
    }
  ],
  "pagination": {
    "first": "https://telemetry.betterstack.com/api/v1/source-groups/95251342/sources?page=1",
    "last": "https://telemetry.betterstack.com/api/v1/source-groups/95251342/sources?page=1",
    "prev": null,
    "next": null
  }
}

Response attributes

id
string

The ID of the source.

type
string

The resource type, always source.

attributes.source_group_id
integer or null

The ID of the source group the source belongs to, or null when the source isn't in a group.

attributes.team_id
integer

The ID of the team that owns the source.

attributes.team_name
string

The name of the team that owns the source.

attributes.name
string

The name of the source.

attributes.platform
string

The platform of the source, for example nginx.

attributes.table_name
string

The table name used to query the source's data.

attributes.token
string

The source token that authenticates data sent to the source.

attributes.ingesting_paused
boolean

Whether ingesting is paused for the source.

attributes.ingesting_host
string or null

The host to send the source's data to, or null for the prometheus_scrape and cloudflare_prometheus_exporter platforms, where Better Stack scrapes the data instead.

attributes.created_at
string

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

attributes.updated_at
string

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

attributes.retention
integer

Data retention for logs in days, a deprecated duplicate of logs_retention.

attributes.logs_retention
integer

Data retention for logs in days.

attributes.metrics_retention
integer

Data retention for metrics in days.

attributes.live_tail_pattern
string or null

The live tail message format with columns wrapped in {column} brackets, or null when the source uses the default format.

attributes.scrape_urls
array

The URLs Better Stack scrapes, present only for the prometheus_scrape and cloudflare_prometheus_exporter platforms.

attributes.scrape_frequency_secs
integer

How often the URLs are scraped in seconds, one of 15, 30, 60, 120 or 300, present only for the prometheus_scrape and cloudflare_prometheus_exporter platforms.

attributes.scrape_request_headers
array

Request headers sent with each scrape as objects with name and value fields, present only for the prometheus_scrape and cloudflare_prometheus_exporter platforms.

attributes.scrape_request_basic_auth_user
string or null

The basic auth username for scraping or null when none is set, present only for the prometheus_scrape and cloudflare_prometheus_exporter platforms.

attributes.scrape_request_basic_auth_password
string or null

The basic auth password for scraping or null when none is set, present only for the prometheus_scrape and cloudflare_prometheus_exporter platforms.

attributes.skip_ssl_verify
boolean

Whether SSL/TLS certificate verification is skipped when scraping, present only for the prometheus_scrape and cloudflare_prometheus_exporter platforms.

attributes.data_region
string

The storage region of the source's data, for example eu-nbg-2.

attributes.custom_bucket
object or null

The custom S3-compatible bucket that hosts the source's data, or null when the source uses Better Stack storage.

attributes.custom_bucket.name
string

The name of the bucket.

attributes.custom_bucket.endpoint
string

The full URL endpoint of the bucket.

attributes.custom_bucket.access_key_id
string

The access key ID used to access the bucket, whose secret access key is never returned.

attributes.custom_bucket.keep_data_after_retention
boolean

Whether data stays in the bucket after the retention period.

attributes.vrl_transformation
string

The VRL code applied to logs during ingestion, a deprecated duplicate of vrl_transformation_logs.

attributes.vrl_transformation_logs
string

The VRL code applied to logs during ingestion, or an empty string when there's none or it equals the platform default.

attributes.vrl_transformation_spans
string

The VRL code applied to traces during ingestion, or an empty string when there's none.

attributes.blocked_metrics
array

Metric names marked as spam, which are rejected during ingestion and aren't billed.

pagination.first
string

URL of the first page. Read more about pagination.

pagination.last
string

URL of the last page.

pagination.prev
string or null

URL of the previous page, or null on the first page.

pagination.next
string or null

URL of the next page, or null on the last page.

Example cURL

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


Previous article

Get a single source group

Next article

Create a source group