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

Get a single release

Retrieves a specific release by its ID.

GET https://errors.betterstack.com/api/v1/releases/{id}

URL parameters

id
required string

The ID of the release to retrieve.

Headers

Authorization
required string

Bearer $TOKEN

200

Returns the requested release.

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

Example cURL

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


Previous article

List all releases

Next article

Create a release