---
title: "List Blocklists"
method: GET
path: "/v3/workspaces/{workspace_id}/blocklists"
tags: ["Blocklists"]
---

# List Blocklists

`GET /v3/workspaces/{workspace_id}/blocklists`

List all blocklists for a workspace. Results are paginated via `limit` and `offset` query parameters.

## Path parameters

- `workspace_id` string, uuid, required

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

OK - blocklists returned.

- ListBlocklistsResponse
  - `blocklists` BlocklistResponse[]
    - `id` string, uuid — Blocklist ID.
    - `workspace_id` string, uuid — Owning workspace ID.
    - `query` string — GNQL query that defines the blocklist.
    - `query_hash` string — Hash of the GNQL query.
    - `name` string, nullable — Human-readable name for the blocklist.
    - `ip_limit` integer, nullable — Maximum number of IPs the blocklist will return.
    - `entitlement_level` string — The entitlement level used when the blocklist was created.
    - `enabled` boolean — Whether the blocklist is active.
    - `last_ip_count` integer — Number of IPs returned on last refresh.
    - `query_workspace_id` string, uuid — Workspace whose data the query runs against, when different from the owning workspace.
    - `token` string — Opaque token for unauthenticated blocklist access. Returned on list, create, and single-get operations.
    - `created_at` string, date-time — Creation timestamp.
    - `updated_at` string, date-time — Last update timestamp.
  - `total` integer — Total number of blocklists in the workspace.
  - `limit` integer — Page size used for the request.
  - `offset` integer — Offset used for the request.

## Other responses

- `400` — Bad request - request syntax is invalid for the specified endpoint. Verify request syntax and try again.
- `401` — Unauthorized. Please check your API key.
- `403` — Forbidden - request is not authorized due to an invalid API key or plan limitations. If due to plan limitations, contact sales@greynoise.io to upgrade your plan and unlock full results.
- `500` — Unexpected error

---

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