Bellwork
Start free
Transitions

Search the leadership transitions feed

Enterprise catalog-wide feed over deduped K-12 leadership transition events (`leadership_transitions`) -- one row per person moving into or out of one role at one district, tracked through its lifecycle (rumored → search → finalist → confirmed → effective → departed). Filter by role class, state, lifecycle stage, transition type, buying intent, announced-date window, and a person/district keyword. Defaults exclude historical-reference mentions and district-unresolved events. Gated by the `leadership_transitions` module entitlement; otherwise responds 403 entitlement_required.

GET
/transitions

Enterprise catalog-wide feed over deduped K-12 leadership transition events (leadership_transitions) -- one row per person moving into or out of one role at one district, tracked through its lifecycle (rumored → search → finalist → confirmed → effective → departed). Filter by role class, state, lifecycle stage, transition type, buying intent, announced-date window, and a person/district keyword. Defaults exclude historical-reference mentions and district-unresolved events. Gated by the leadership_transitions module entitlement; otherwise responds 403 entitlement_required.

Authorization

AuthorizationBearer <token>

API key (sk_live_... prefix). Generate keys in the UI under Settings > API Keys, then send it as Authorization: Bearer sk_live_...

In: header

Query Parameters

role?string

Comma-separated role classes: superintendent, board, cabinet, other

state?string

Comma-separated two-letter district state codes

status?string

Comma-separated lifecycle stages: rumored, search, finalist, confirmed, effective, departed

type?string

Comma-separated transition types: incoming, outgoing, interim, finalist, officer, other

intent?string

Comma-separated buying-intent buckets: high, medium, low, none

q?string

Keyword search on person name or district name

contact_id?string

Only transitions linked to this contact record — the contact peek's leadership block

Match^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$
Formatuuid
announced_after?string

Only events announced on/after this ISO date (announced_date).

announced_before?string

Only events announced on/before this ISO date (announced_date).

include_historical?string

Include historical-reference events (default false)

Value in"true" | "false"
include_unresolved?string

Include events with an unresolved district (default false)

Value in"true" | "false"
sort?string

Sort by announced_date (default) or effective_date, desc

Default"announced"
Value in"announced" | "effective"
limit?integer
Default25
Range1 <= value <= 100
offset?integer
Default0
Range0 <= value <= 9007199254740991

Response Body

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://loading/api/v1/transitions"
{
  "data": [
    {
      "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08",
      "district_id": "880bc4ee-477a-4e12-a0f0-c89f020ba05d",
      "district_name": "string",
      "district_state": "string",
      "resolution_status": "string",
      "contact_id": "f245e2a3-e141-4d41-912c-b1c1f5bd5598",
      "person_name": "string",
      "role_class": "superintendent",
      "role_title": "string",
      "transition_type": "incoming",
      "event_direction": "entry",
      "status": "rumored",
      "announced_date": "string",
      "effective_date": "string",
      "date_confidence": "string",
      "historical_reference": true,
      "buying_intent": "high",
      "review_status": "string",
      "source_count": 0,
      "first_seen": "string",
      "last_seen": "string"
    }
  ],
  "pagination": {
    "total": -9007199254740991,
    "limit": -9007199254740991,
    "offset": -9007199254740991,
    "has_more": true
  }
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}
{
  "error": "entitlement_required",
  "module": "string",
  "message": "string",
  "contact": "string"
}
{
  "error": "string",
  "message": "string",
  "statusCode": -9007199254740991
}

Search the enterprise signals feed GET

Enterprise catalog-wide signals feed -- the same underlying data and query shape as GET /news, but accessible via session, OAuth, or API-key auth (not API-key-only), and gated by the `signals` module entitlement instead of `news_signals`. Org must have the Signals Feed module enabled; otherwise responds 403 entitlement_required.

Get person briefs for a set of transitions GET

Batched read of agent-researched person briefs for the binder: every (project, transition) brief among the given transition ids, keyed by transition id. A brief carries the seller-specific margin note, the narrative read, sourced facts, and confidence. Same `leadership_transitions` module gate as GET /transitions; the project_id must belong to the caller's organization.