veil

Read public moderation entries

Page through public moderation, badge and badge-removal log entries.

GET/v1/moderation/entries
Access
Public; API key optional
Client
Browser fetch supported

Parameters#

NameLocationMeaning
afterQueryExclusive log index. Default -1.
limitQuery1 to 500. Default 200.

Request examples#

cURL
curl -fsS 'https://veil.rip/v1/moderation/entries?limit=20'
javascript
const response = await fetch("https://veil.rip/v1/moderation/entries?limit=20");
const result = await response.json();

Try the request#

Response#

HTTP 200application/json

org, entries and next. Entries are ordered by log index. Follow next until null.

FieldTypeMeaning
orginteger | nullStaff organisation number.
entriesarray<object>Log-ordered public moderation and badge entries. Rows contain logIndex, kind, id, n, action, badge, category, key, since, until, publishedAt, commitment, role and revertedBy.
nextinteger | nullPass as after to read the next page.

Response headers#

HeaderValueMeaning
Content-Typeapplication/jsonUse the declared media type before choosing a parser.
DateHTTP dateServer time. Compare it with your clock when signing requests.
Retry-Afterinteger seconds, on rate_limited or busyWait at least this long before retrying. Other 429/503 codes do not necessarily include it.

Errors#

API errors return an error object. Use error.code for program logic; error.message is English text for people and can change. Response and error guide

HTTPCodeMeaning and next step
400invalid_parameter

A path, query or body field is missing, malformed or outside its accepted range.

Correct the field named in error.message before sending again.

When using an optional API key
HTTPCodeMeaning and next step
401invalid_api_key

The bearer credential is malformed, unknown, expired or revoked.

Use an active key. To use anonymous public access, remove Authorization entirely. Invalid credentials never fall back automatically.

403api_key_scope

The API key lacks read or verify scope, or the endpoint does not accept bearer keys.

Use the correct scope. Identity writes and key management still require a device signature.

403api_key_suspended

This API key is suspended.

Ask staff to restore it; another key cannot lift an account suspension.

403developer_suspended

The owner’s API account is suspended or the owner card is unavailable.

Check the owner account and any staff restriction. Creating another key does not bypass suspension.

Shared request errors
HTTPCodeMeaning and next step
429rate_limited

An anonymous, signed-request or API-key allowance was exceeded.

Wait at least Retry-After seconds. Share a queue and retry budget across your workers.

500internal_error

An unexpected server error occurred. Internal details are not returned.

Retry reads with bounded backoff. Check write results before sending a new signed operation.

503busy

The application has reached a temporary concurrency or database limit.

Wait Retry-After seconds and retry with bounded backoff.