/api/v1/announcementsGETPaginated feed of governance notices, newest first: rebalances, methodology updates, and corporate actions. Rebalance notices carry the markets added and removed from the basket, so a level move can be told apart from a news-driven change. One change that touches several indices is a single row tagging all of them.
Authorization
bearerAuth *Bearer <token>
Session token from the app, or an API key (the
ak_ prefix), sent as a Bearer token or an ?api_key= query parameter.. Token in: headerQuery Parameters
type?"rebalancing" | "methodology" | "corporate_action" | "correction" | "termination" | "factsheet" | "policy"
Exact notice kind. Unknown values return 400.
from?string
Inclusive lower bound on notice date. A bare date is 00:00:00 UTC of that day. RFC3339 is used as-is.
to?string
Inclusive upper bound on notice date. A bare date is 23:59:59.999 UTC of that day. RFC3339 is used as-is.
index?string
Restrict to notices tagged with this index ticker. Case-insensitive.
page?integer
Default:
1Min: 1per_page?integer
Default:
50Min: 1Max: 200Response
200 · Paged announcements, newest notice first.
data *object[]
Show item properties
id *string
Stable public id.
type *"rebalancing" | "methodology" | "corporate_action" | "correction" | "termination" | "factsheet" | "policy"
notice_date *string (date-time)
When the change was announced.
effective_date?string (date-time)
When the change takes effect. Omitted when it is the notice date.
title *string
body?string
Plain-text narrative. Omitted when the notice has no body.
affected_indices *string[]
Index tickers this notice applies to. One change that fans across several indices is one row.
added_markets *string[]
Market ids added to the basket. Empty for non-rebalances.
removed_markets *string[]
Market ids removed from the basket.
provenance *object
Source back-pointer object.
meta *object
Show properties
total?integernull
Total number of records matching the request across every page, not just the current one. null on an uncounted list; page using has_next. A relevance-ranked search is uncounted, and a searched events list stays uncounted even with sort. A searched markets list with sort returns a total over the ranked matches (at most 10,000).
page?integer
The 1-based page number this response covers.
per_page?integer
Maximum number of items on a page. The last page may hold fewer.
total_pages?integernull
Total number of pages available at the current per_page. null whenever total is null; page using has_next.
has_next?boolean
True when a page exists after this one.
has_prev?boolean
True when this is not the first page.
total_capped?boolean
True when
total and total_pages reflect the server's counting ceiling rather than the exact matched count: the real set is at least total large. Render such totals as a lower bound (for example "10,000+"). Omitted when the count is exact. A sorted markets search that fills the 10,000-candidate ceiling sets this flag.400 · Invalid type, from, or to.
error?string
Stable, machine-readable code identifying the failure; branch on this rather than on
message. One of bad_request, unauthorized, forbidden, not_found, conflict, service_unavailable, upstream_error, service_error, or internal_error.message?string
Human-readable explanation, safe to show to a user. For client errors it names the specific problem; for server-side failures it is a generic notice and the underlying detail is deliberately withheld.
401 · Unauthorized
error?string
Human-readable reason the request was not authenticated or authorized, for example a missing or malformed
Authorization header, an invalid token, or a token lacking the required scope. This is free text whose wording can change, so branch on status (or the HTTP status code) instead of on this string.status?integer
The HTTP status code repeated in the body.
403 · The organization has no paid plan, so the realtime read scopes are refused. Distinct from a 429, which means a plan's budget ran out: nothing here resets on a timer, and the request succeeds only once the organization holds a plan.
error *string
Human-readable reason the request was refused.
status *integer
HTTP status code, repeated in the body.
upgrade_url?string (uri)
Page listing the plans and their request allowances, for buying access. Absent when no plan is available for purchase.
429 · The organization's minute or UTC-day request budget is exhausted, or the organization has reached its cap on requests running at the same time (`limit: "concurrency"`). Wait `Retry-After` seconds before retrying; for a concurrency 429, reduce parallelism.
error *"rate_limited"
Always
rate_limited. Branch on this to detect a throttled request.limit *"rpm" | "daily" | "concurrency"
Which limit was hit:
rpm for the per-minute cap, daily for the daily one, or concurrency for the cap on requests running at the same time.message *string
Human-readable explanation naming the limit that was exceeded.
upgrade_url?string (uri)
Page listing the plans and their request allowances, for buying a larger budget. Absent when no plan is available for purchase.