Imagery
Get Imagery Request
Fetch the latest status and delivery URL for one imagery request owned by the authorized account.
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
Path parameters
request_idstring uuid required
Imagery request identifier returned by POST /wine_labels.
Query parameters
user_idstring uuid
Account identifier. Optional when the request uses an authorized Authorization header.
Response
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 required
Changes
No recorded changes to this operation across all 1 revision of this API.