---
title: "List block list entries"
method: GET
path: "/v1/block-list"
tags: ["lists"]
---

# List block list entries

`GET /v1/block-list`

## Request

- Base URL: `https://api.skanqrcode.com`
- URL: `https://api.skanqrcode.com/v1/block-list`
- Auth: HTTP bearer

Lists this tenant's block list entries, newest first. Available on every plan. Entries are private to the tenant.

## Query parameters

- `limit` integer: Page size, 1-500 (default 100).
- `cursor` string: `nextCursor` from the previous page.

## Response `200`

A page of entries.

- ListEntriesResponse
  - `entries` ListEntry[], required
    - `id` string, required
    - `matchType` 'url' | 'host' | 'domain' | 'ip', required: What the entry matches: an exact URL, a hostname, a registrable domain (including its subdomains), or an IP address.
    - `value` string, required: The host, domain or IP as entered. For URL entries only the registrable domain and a short hash hint are shown.
    - `createdAt` string, required: RFC 3339, UTC.
  - `nextCursor` string, nullable, required

## Other responses

- `400`: The request failed validation (malformed JSON, bad field, unparseable target, or a body over 8 KB).
- `401`: The API key is missing, malformed, unknown or revoked.
- `402`: The tenant is suspended for non-payment.
- `403`: The request is not allowed: the key lacks the required scope or the account has been blocked (`forbidden`), or the plan does not include the feature (`plan_feature_unavailable`).
- `429`: The per-minute rate limit (`rate_limited`) or the monthly quota (`quota_exceeded`) was exceeded. Blocked requests are not billed. Back off for `Retry-After` seconds.
- `500`: Unexpected failure. Never contains stack traces, internal hostnames or upstream error bodies.
- `503`: Authentication is temporarily unavailable for a key that has not been seen recently. Retry shortly.

---

[API](https://skmtc.dev/skanqrcode/apis/skanqrcode-api.md) · [All operations](https://skmtc.dev/skanqrcode/apis/skanqrcode-api/llms.txt) · [OpenAPI document](https://skmtc.dev/skanqrcode/apis/skanqrcode-api/revisions/f307ade24b00?raw)