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

Get a single group

Retrieves a specific application group by its ID.

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

URL parameters

id
required string

The ID of the application group to retrieve.

Headers

Authorization
required string

Bearer $TOKEN

200

Returns the requested application group.

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

Unauthorized

Response body

{
  "errors": "Invalid authentication"
}
404

Not Found

Response body

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

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.

Example cURL

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


Previous article

List all groups

Next article

Create a group