Get transitions relevant to a profile
The curated slice of the transitions feed for one profile, selected deterministically: transitions in districts the profile follows or has opportunities in rank first, then territory-state matches, weighted by freshness of the move and buying intent. Each row carries a `relevance` object with the score and human-readable connection reasons. Same `leadership_transitions` module gate as GET /transitions; the project_id must belong to the caller's organization.
The curated slice of the transitions feed for one profile, selected deterministically: transitions in districts the profile follows or has opportunities in rank first, then territory-state matches, weighted by freshness of the move and buying intent. Each row carries a relevance object with the score and human-readable connection reasons. Same leadership_transitions module gate as GET /transitions; the project_id must belong to the caller's organization.
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
Profile (project) whose follows, opportunities, and territory define relevance
^([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)$uuid401 <= value <= 60Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://loading/api/v1/transitions/relevant?project_id=497f6eca-6276-4993-bfeb-53cbbbba6f08"{
"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",
"relevance": {
"score": 0,
"reasons": [
"string"
]
}
}
],
"scope": {
"followed_districts": 0,
"opportunity_districts": 0,
"territory_states": [
"string"
]
}
}{
"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
}Get the relevancy agent's current slate GET
The seller's current slate from the leadership-relevancy agent: the transitions it judged most worth their attention, each with the agent's rationale and rank. Replaced nightly. Empty until the first run. Same `leadership_transitions` module gate as GET /transitions; the project_id must belong to the caller's organization.
Get monthly transition counts GET
Twelve trailing calendar months of transition counts (by announced date, linked + non-historical, optional role filter) -- the seasonal rhythm of leadership movement. Same `leadership_transitions` module gate as GET /transitions.