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
    4. Releases API
      1. List all releases GET
      2. Get a single release GET
      3. Create a release POST
      4. Remove a release DELETE

List all releases

Lists all releases for your team.

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

Query parameters

team_name
string

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

application_id
integer

Filter by application ID

version
string

Filter by version (exact match)

environment
string

Filter by environment. Pass an array to match releases deployed to any of the listed environments, for example environment[]=canary&environment[]=staging.

from
string

Only return releases first seen at or after this ISO8601 timestamp

to
string

Only return releases first seen at or before this ISO8601 timestamp

page
integer

Page number

per_page
integer

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

Headers

Authorization
required string

Bearer $TOKEN

200

Returns a paginated list of releases, newest first. The origin attribute is reported for releases registered via this API or the Sentry CLI, and detected for releases discovered automatically from the first error event carrying the version. last_seen_at only advances when an error event arrives. A release registered at build time keeps its first_seen_at value until its first error, and last_seen_at is null on a release with no error activity recorded.

Response body

{
  "data": [
    {
      "id": "456",
      "type": "release",
      "attributes": {
        "version": "v1.2.3",
        "application_id": 123,
        "environments": [
          "production"
        ],
        "first_seen_at": "2026-08-18T09:00:00.000Z",
        "last_seen_at": "2026-08-18T09:00:00.000Z",
        "origin": "reported",
        "created_at": "2026-08-18T09:00:00.000Z",
        "updated_at": "2026-08-18T09:00:00.000Z"
      }
    }
  ],
  "pagination": {
    "first": "https://errors.betterstack.com/api/v1/releases?page=1&per_page=50",
    "last": "https://errors.betterstack.com/api/v1/releases?page=3&per_page=50",
    "prev": null,
    "next": "https://errors.betterstack.com/api/v1/releases?page=2&per_page=50"
  }
}
401

Unauthorized

Response body

{
  "errors": "Invalid authentication"
}
422

Unprocessable Entity - Invalid Timestamp

Response body

{
  "errors": "Sorry, some values are incorrect",
  "invalid_values": {
    "from": "Invalid timestamp, use ISO8601"
  }
}

Example cURL

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


Pagination

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

Previous article

List applications in a group

Next article

Get a single release