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

Items per page (default: 50, max: 100)

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

Example cURL

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


Pagination

This endpoint supports pagination. Default is 50 items per page, with a maximum of 100 items per page. The pagination links are provided in the pagination object within the response body.

Previous article

Remove an application

Next article

Get a single group