---
title: "List your block and allow list entries"
method: GET
path: "/lists/entries"
tags: ["Lists"]
---

# List your block and allow list entries

`GET /lists/entries`

## Request

- Base URL: `https://developers.ozav.io/v2`
- URL: `https://developers.ozav.io/v2/lists/entries`
- Auth: one of:
  - API key in header `X-API-Key`
  - HTTP bearer

Lists your active entries, newest first, with the standard cursor pagination.

## Query parameters

- `limit` integer
- `starting_after` string
- `list` 'block' | 'allow'

## Response `200`

Paginated entries.

- object: The uniform envelope every list endpoint returns.
  - `data` ListEntry[], required: The page of results. Each list endpoint documents its own item type.
    - `id` string, required: The entry id (`ozav_lst_...`).
    - `object` 'list_entry', required: Always the literal `list_entry`.
    - `list` 'block' | 'allow', required: `block` or `allow`.
    - `type` 'name' | 'document' | 'email' | 'email_domain', required: The value type.
    - `action` 'review' | 'decline' | 'null', nullable: `review` or `decline` for block entries; `null` for allow entries.
    - `value_hint` string, required: A masked hint of the value (e.g. `J*** D***`, `•••789`, `j***@***`). Never the full value, never an email domain; a document shorter than 8 characters shows only `•••`.
    - `created_at` string, date-time, required: When the entry was created.
  - `has_more` boolean, required: True when more results exist beyond this page - keep paging with `starting_after`.
  - `next_cursor` string, nullable: Opaque cursor for the next page; pass it as `starting_after`. Null on the last page.

## Other responses

- `400`: The request is invalid.
- `401`: Missing or invalid API key.
- `503`: A dependency OZAV needs (storage, a resource lookup) could not be reached, so OZAV fails closed rather than guess. Safe to retry with the same `Idempotency-Key` where the operation accepts one.

---

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