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

Unauthorized

Response body

{
  "errors": "Invalid authentication"
}
404

Not Found

Response body

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

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