---
title: "List Blocklist Items"
method: GET
path: "/blocklists"
tags: ["Blocklist"]
---

# List Blocklist Items

`GET /blocklists`

Retrieve a list of paginated blocklist entries.

### Required API key scope
- Orders

## Response `200`

Success

- PaginatedBlocklistResponse
  - `data` BlocklistEntryWithCreatedAtResponse[] — The data for each entry in the blocklist.
    - `id` integer — The unique identifier associated with the blocklist entry.
    - `type` 'order' | 'email' | 'product' | 'product_tag' — The type of value blocked by this blocklist entry. `order` is the order number of the blocked order, `email` is the blocked customer's email address, `product` is the variant ID of the blocked product, and `product_tag` disables returns for all products with that tag.
    - `value` string — The blocked value. Items purchased using this value will be ineligible for return.
    - `secondary_value` string, nullable — An additional blocked value associated with this entry. Items purchased using this value will also be ineligible for return.
    - `created_at` string, date-time, nullable — The date and time at which the entry was created.
  - `links` PaginatedBlocklistLink[]
    - `url` string — The link to a page.
    - `label` string — The page's label, used to store either page numbers or previous/next page data.
    - `active` boolean — Whether the page is active.
  - `next_page_url` string, nullable — The link to the next page of paginated results.
  - `current_page` integer — The identifier associated with the current page.
  - `from` string, nullable — The number of the first blocklist entry on the page.
  - `first_page_url` string, nullable — The link to the first page of paginated results.
  - `last_page` string, nullable — The identifier associated with the last page.
  - `last_page_url` string, nullable — The link to the last page of paginated results.
  - `path` string, nullable — The endpoint's path.
  - `per_page` integer — The number of blocklist entries per page.
  - `prev_page_url` string, nullable — The link to the previous page of paginated results.
  - `to` integer, nullable — The number of the last blocklist entry on the page.
  - `total` integer — The total number of blocklist entries returned.

## Other responses

- `401` — Unauthorized

---

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