---
title: "Resolve a version to its image release"
method: GET
path: "/releases/{channel}/{version}"
---

# Resolve a version to its image release

`GET /releases/{channel}/{version}`

## Request

- Base URL: `https://app.gecko.security/api/v1`
- URL: `https://app.gecko.security/api/v1/releases/{channel}/{version}`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Looks up one release by version within a channel. The path version matches either the customer release version (for example `1.1`) or the Gecko scanner version (for example `1.1.0`). When the same scanner version was pushed more than once, the newest release is returned. Pull the digest-pinned `image_ref`, never a mutable tag.

## Path parameters

- `channel` string, required: Release channel name. Channel names are shared privately by your Gecko account contact and are not listed publicly.
- `version` string, required: Either the customer release version (for example `1.1`) or the Gecko scanner version (for example `1.1.0`).

## Response `200`

Success

- ImageRelease
  - `object` 'image_release', required
  - `channel` string, required: Release channel name. Channel names are shared privately by your Gecko account contact and are not listed publicly.
  - `version` string, required
  - `git_sha` string, required
  - `image_digest` string, required
  - `image_uri` string, required
  - `image_ref` string, required
  - `pull_command` string, required
  - `pushed_at` string, required
  - `notes` string, nullable, required

## Other responses

- `401`: Authentication error
- `403`: Authorization error
- `404`: Not found
- `429`: Rate limited

---

[API](https://skmtc.dev/gecko/apis/gecko-security-api.md) - [All operations](https://skmtc.dev/gecko/apis/gecko-security-api/llms.txt) - [OpenAPI document](https://skmtc.dev/gecko/apis/gecko-security-api/revisions/9da49dae8b07?raw)