Explore documentation
  1. Welcome to Errors 👋
  2. Collecting errors
    1. Integrating using an AI prompt
    2. Sentry SDK
  3. Using the product
    1. Exception grouping
    2. Fix with AI
    3. Releases
  4. Integrations
    1. Reporting incidents
    2. Slack
    3. Microsoft Teams
    4. Linear
    5. Jira
  5. Errors API
    1. Getting an API token
    2. Applications API
      1. List all applications GET
      2. Get a single application GET
      3. Create an application POST
      4. Update an application PUT
      5. Remove an application DELETE
    3. Application groups API

List all applications

Lists all error tracking applications for your team.

GET https://errors.betterstack.com/api/v1/applications

Query parameters

page
integer

Page number

per_page
integer

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

name
string

Filter by application name (case-insensitive partial match)

Headers

Authorization
required string

Bearer $TOKEN

200

Returns a paginated list of applications.

Response body

{
  "data": [
    {
      "id": "1234",
      "type": "application",
      "attributes": {
        "application_group_id": 5678,
        "team_id": 123456,
        "team_name": "example-team",
        "name": "my-web-app",
        "table_name": "my_web_app",
        "token": "abc123def456ghi789",
        "ingesting_paused": false,
        "ingesting_host": "s1234.us-east-9.betterstackdata.com",
        "created_at": "2025-01-15T10:30:00.000Z",
        "updated_at": "2025-01-15T10:30:00.000Z",
        "errors_retention": 90,
        "data_region": "us-east-9",
        "custom_bucket": null
      }
    }
  ],
  "pagination": {
    "first": "https://errors.betterstack.com/api/v1/applications?page=1&per_page=50",
    "last": "https://errors.betterstack.com/api/v1/applications?page=3&per_page=50",
    "prev": null,
    "next": "https://errors.betterstack.com/api/v1/applications?page=2&per_page=50"
  }
}
401

Unauthorized

Response body

{
  "errors": "Invalid authentication"
}

Example cURL

Example
curl --request GET \
  --url https://errors.betterstack.com/api/v1/applications \
  --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

Getting started with Errors API

Next article

Get a single application