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.

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

Response attributes

id
string

The ID of the release.

type
string

Always release.

attributes.version
string

The version of the release, such as v1.2.3.

attributes.application_id
integer

The ID of the application the release belongs to.

attributes.environments
array

The environments the release was reported for or seen in, such as production, or an empty array when none is known.

attributes.first_seen_at
string

When the release was registered or first seen in an event, whichever came first, as an ISO 8601 date-time in UTC.

attributes.last_seen_at
string or null

When an event last carried the release, as an ISO 8601 date-time in UTC, equal to first_seen_at on a registered release until its first event, or null when no event has been recorded for it since this field was added.

attributes.origin
string

How the release was recorded: reported when registered through this API or the Sentry CLI, or detected when discovered from the first event carrying the version.

attributes.created_at
string

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

attributes.updated_at
string

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

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/releases \
  --header "Authorization: Bearer $TOKEN"


Previous article

List applications in a group

Next article

Get a single release