List active site notices
Returns the operator-authored banners the website is currently showing, best first. Only published notices inside their display window appear, so an empty array is the normal state.
- stringheader
Optional. Without a key this endpoint answers under the public policy; a key raises your limits and unlocks plan-gated fields.
Authorization: Bearer <key>is accepted in its place.
- object
The response payload.
- SiteNotice[]
Published notices inside their display window, best first: highest priority, then newest.
- string
Row id of the notice. The website keys its dismissal on this, so a new notice is seen even by a reader who dismissed the last one.
- string
Short label shown before the message.
- string
The sentence shown in the banner.
- string
A second line, shown under the highlight where one is set.
- NoticeVariant
How prominently a site notice is shown.
- string | null
Text of the call to action, or null when the banner has none.
- string | null
Where the call to action goes.
- integer
Higher sorts first. Ties break on newest.
- string | null
When the notice becomes visible. Null means immediately.
- string | null
When it stops being shown. This is why notices are rows rather than copy: an end date is the only version of "take this down later" that does not rely on somebody remembering.
- 400
VALIDATION_ERRORValidation error - 429
RATE_LIMITEDRate limit exceeded - 500
INTERNAL_ERRORUnexpected server error
- Minimum tier
- Explorer+
- Monthly quota
- 200/mo
- Rate limit
- 10/min
- Daily cap
- 50
Figures shown are for this endpoint's minimum tier. Higher tiers raise every limit.