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

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

Example cURL

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