---
title: "List Imagery Requests"
method: GET
path: "/wine_labels"
tags: ["Imagery"]
---

# List Imagery Requests

`GET /wine_labels`

## Request

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

List imagery requests for the authorized account, with optional status filtering and pagination.

## Query parameters

- `user_id` string, uuid
- `status` string
- `limit` integer
- `offset` integer

## Response `200`

Response highlights:
- `requests[]`: request records in newest-first order.
- `credits`: current Imagery delivery-credit balance.
- `total`, `limit`, and `offset`: pagination metadata.

Notes:
- Fulfilled records return the canonical hash-only signed URL in `request.asset_url`.
- Cancelled requests are excluded by default. Use `status=cancelled` to inspect cancellation history.
- Use the dashboard at `https://winelabs.ai/api/imagery-requests` to upload a CSV and review the same queue visually.

- 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)