---
title: "List Label Requests"
method: GET
path: "/label-requests"
tags: ["Label Requests"]
---

# List Label Requests

`GET /label-requests`

Retrieve a list of label requests.

#### Required API key scope
- Label Requests (Read)

## Query parameters

- `from` string, date-time
- `to` string, date-time
- `return_id` integer
- `status` 'issued' | 'cancelled' | 'fulfilled' — The status of the label request.
- `limit` integer
- `offset` integer

## Response `200`

Success

- object
  - `data` LabelRequestResponse[]
    - `id` string, required — The unique identifier for the label request, created by Loop.
    - `addresses` object, required
      - `origin` Address, required
        - `id` integer
        - `hash` string
        - `created_at` string, date-time
        - `updated_at` string, date-time
        - `name` string
        - `company` string, nullable
        - `address1` string
        - `address2` string
        - `city` string
        - `state` string
        - `zip` string
        - `country` string
        - `country_code` string
        - `phone` string
        - `latitude` number
        - `longitude` number
      - `destination` Address, required
        - `id` integer
        - `hash` string
        - `created_at` string, date-time
        - `updated_at` string, date-time
        - `name` string
        - `company` string, nullable
        - `address1` string
        - `address2` string
        - `city` string
        - `state` string
        - `zip` string
        - `country` string
        - `country_code` string
        - `phone` string
        - `latitude` number
        - `longitude` number
    - `parcel` object, required
      - `height` number, double, required — The height of the parcel in inches.
      - `length` number, double, required — The length of the parcel in inches.
      - `width` number, double, required — The width of the parcel in inches.
      - `weight` number, double, required — The weight of the parcel in grams.
    - `products` Product[], required
      - `id` integer, required — The global identifier for an existing product.
    - `errors` LabelRequestErrorResponse[], required
      - `reason` 'INSUFFICIENT_FUNDS' | 'INVALID_ADDRESS' | 'Other', required — The error reason.
      - `message` string, nullable — The message associated with the label request error.
      - `created_at` string, date-time
    - `return_id` integer, required — The return id of the return.
    - `shop_id` integer, required — The id of the shop belonging to the merchant.
    - `status` 'issued' | 'cancelled' | 'fulfilled', required — The status of the label request.
    - `created_at` string, date-time, required

## Other responses

- `401` — Unauthorized
- `404` — Resource Not Found

---

[API](https://skmtc.dev/loopreturns/apis/listings-api.md) · [All operations](https://skmtc.dev/loopreturns/apis/listings-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/loopreturns/listings-api/revisions/750e6012dbb8/schema)