Explore documentation
  1. Welcome to Errors
    1. JavaScript tag
  2. Collecting errors
    1. Integrating using an AI prompt
    2. Sentry SDK
  3. Using the product
    1. Exception grouping
    2. AI prompt
    3. Releases
    4. Uploading source maps
    5. Spike protection
  4. Integrations
    1. Reporting incidents
    2. Slack
    3. Microsoft Teams
    4. Linear
    5. Jira
    6. GitHub
    7. Outgoing webhooks
  5. Errors API
    1. Getting an API token
    2. Applications API
    3. Application groups API
      1. List all groups GET
      2. Get a single group GET
      3. Create a group POST
      4. Update a group PATCH
      5. Remove a group DELETE
      6. List applications in a group GET
    4. Releases API

List all groups

Lists all application groups for your team.

GET https://errors.betterstack.com/api/v1/application-groups

Query parameters

team_name
string

Filter application groups belonging to a specified team when using global API token.

page
integer

Page number

per_page
integer

Number of application groups per page. Default 50, maximum 250.

Headers

Authorization
required string

Bearer $TOKEN

200

Returns a paginated list of application groups.

Response body

{
  "data": [
    {
      "id": "5678",
      "type": "application_group",
      "attributes": {
        "name": "production-apps",
        "created_at": "2025-01-15T10:25:00.000Z",
        "updated_at": "2025-01-15T10:25:00.000Z",
        "sort_index": null,
        "team_name": "example-team"
      }
    }
  ],
  "pagination": {
    "first": "https://errors.betterstack.com/api/v1/application-groups?page=1&per_page=50",
    "last": "https://errors.betterstack.com/api/v1/application-groups?page=1&per_page=50",
    "prev": null,
    "next": null
  }
}
401

Unauthorized

Response body

{
  "errors": "Invalid authentication"
}

Response attributes

id
string

The ID of the application group.

type
string

Always application_group.

attributes.name
string

The name of the application group.

attributes.created_at
string

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

attributes.updated_at
string

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

attributes.sort_index
integer or null

The position of the group in your list of application groups, lower values first, or null when no position was set.

attributes.team_name
string

The name of the team the application group belongs to.

pagination.first
string

The URL of the first page of results. Read more about pagination.

pagination.last
string

The URL of the last page of results.

pagination.prev
string or null

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

pagination.next
string or null

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

Example cURL

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


Previous article

Remove an application

Next article

Get a single group