Skip to content

AdminDomainListFetchPage

A page of the fetches of a subscription, newest first.

object
next_cursor

An opaque pagination cursor. Clients pass it back unchanged and never parse it.

string
>= 1 characters <= 256 characters
items
required
Array<object>

One fetch of a subscribed domain block list.

object
id
required

The ID of a resource, a UUIDv7 in its canonical string form.

string format: uuid
outcome
required

applied: the list was read and replaced the domains the subscription holds. not_modified: the list did not change. failed: nothing was read and nothing changed.

string
Allowed values: applied not_modified failed
http_status

The status code of the answer; omitted when no answer came.

integer
error_code

Why a fetch failed. http_status: the server answered another status than 2xx or 304, such as 401, 403, or 404 of a server that does not publish its domain blocks. network: the server could not be reached or did not answer in time. forbidden_destination: the URL or a redirect leads to an address the server does not fetch from. too_large: the list is larger than 2 MiB. too_many_entries: it has more than 5000 rows. malformed: it cannot be read in the subscription’s format.

string
Allowed values: http_status network forbidden_destination too_large too_many_entries malformed
entry_count
required

The domains the subscription holds after the fetch.

integer
fetched_at
required
string format: date-time

Example generated

{
"next_cursor": "example",
"items": [
{
"id": "01890a5d-ac96-774b-bcce-b302099a8057",
"outcome": "applied",
"http_status": 1,
"error_code": "http_status",
"entry_count": 1,
"fetched_at": "2026-04-15T12:00:00Z"
}
]
}

For LLMs and coding agents:llms.txt,llms-full.txt, llms-small.txt

Analytics on this site