---
title: "Get Imagery Request"
method: GET
path: "/wine_labels/{request_id}"
tags: ["Imagery"]
---

# Get Imagery Request

`GET /wine_labels/{request_id}`

## Request

- Base URL: `https://external-api.wine-labs.com`
- URL: `https://external-api.wine-labs.com/wine_labels/{request_id}`
- Auth: none declared

Fetch the latest status and delivery URL for one imagery request owned by the authorized account.

## Path parameters

- `request_id` string, uuid, required

## Query parameters

- `user_id` string, uuid

## Response `200`

Response highlights:
- `request`: current status, resolved wine identifiers, requested treatment, charge state, and timestamps.
- `request.asset_url`: canonical hash-only signed download URL when fulfilled.
- `credits`: current Imagery delivery-credit balance.

Notes:
- Returns 404 when the request does not exist or does not belong to the authorized account.
- `awaiting_credits` means an image is prepared but has not been delivered or charged. Its `asset_url` is null and `asset_payload` is empty until fulfillment.
- After a credit refill, scheduled retries recheck the prepared image before delivering it. Reuse the existing request instead of submitting a duplicate; delivery is not immediate.
- `request.can_cancel` is the authoritative cancellation eligibility flag. An uncharged request can still be protected by delivery history or a withdrawal hold.

- object

---

[API](https://skmtc.dev/winelabs/apis/wine-labs-api.md) · [All operations](https://skmtc.dev/winelabs/apis/wine-labs-api/llms.txt) · [OpenAPI document](https://skmtc.dev/winelabs/apis/wine-labs-api/revisions/f8898ca9974e?raw)