---
title: "Get push details"
method: GET
path: "/pushes/{id}"
---

# Get push details

`GET /pushes/{id}`

## Request

- Base URL: `http://localhost:4973`
- URL: `http://localhost:4973/pushes/{id}`
- Auth: HTTP bearer

## Path parameters

- `id` string, required

## Response `200`

Push details

- Push
  - `id` string, required: Push job identifier
  - `image` string, required: Hypeman image name (normalized ref)
  - `digest` string, required: Cached manifest digest being pushed
  - `target` string, required: Remote reference the image is pushed to
  - `status` 'queued' | 'pushing' | 'pushed' | 'failed', required
  - `queue_position` integer, nullable: Position in the push queue
  - `error` string, nullable: Error message
  - `layers` integer: Number of layers pushed
  - `bytes` integer: Total compressed layer bytes pushed
  - `created_at` string, date-time, required
  - `completed_at` string, date-time, nullable

## Other responses

- `401`: Unauthorized
- `404`: Push not found
- `500`: Internal server error

## Changes

- **2026-08-21** `b00eacfe26b2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/kernel/apis/hypeman-api/changes/pushes/:id/get.md)

---

[API](https://skmtc.dev/kernel/apis/hypeman-api.md) - [All operations](https://skmtc.dev/kernel/apis/hypeman-api/llms.txt) - [OpenAPI document](https://skmtc.dev/kernel/apis/hypeman-api/revisions/befe3f654ef6?raw)