Get a cited research brief for a ticker or canonical entity
Use exactly one of ticker or released entity_id. Non-listing entity briefs return cited attributed views, recorded conditions, explicit price and benchmark capability gaps, omission counts and a get_beliefs continuation. Default overview returns at most five views; detail=full returns the selected case details. Entity briefs are bounded to 32 KiB; use smaller max_results or Belief ID detail when exceeded. Listing entity IDs retain the existing stock brief and canonical identity. Returns approved public investor thesis summaries for one ticker, including attributed people, claims, revisions, fixed horizon outcomes, a dated market_price with its provider source and freshness, the latest since inception underlying market mark, and provenance labeled BeliefState thesis packets covering changes, reasons, disagreements, catalysts, risks, invalidations, comparable history, unknowns, and citations. Each active thesis includes price_opportunity with explicit author targets, separate horizons, dated prices, remaining conditional price change, and whether the current price is near or beyond the target. Target distances are not expected returns or proof of current thesis validity. Optional sector_context adds separately attributed research from companies with observed SEC industry relationships. It may be the only research available for a discovered listing; do not transfer peer directions, targets, or conviction to the requested company. Missing optional fields remain unknown.
Authorizations
Developer API key created through /auth.md. Never paste it into a retail chat.
Headers
Stable 1–128 character ID for an idempotent retry. Reuse the same value only for the same logical request.
128^[A-Za-z0-9._~:+/=-]+$Query Parameters
1 - 32^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$1 <= x <= 20overview, full Released canonical entity ID from get_beliefs view=entities. Use exactly one of ticker or entity_id.
^([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)$Response
Successful read only response
- Option 1
- Option 2
- Option 3
- Option 4
"overview""security-brief-overview-v1""1"^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$^(?:(?:\d\d[2468][048]|\d\d[13579][26]|\d\d0[48]|[02468][048]00|[13579][26]00)-02-29|\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\d|30)|(?:02)-(?:0[1-9]|1\d|2[0-8])))T(?:(?:[01]\d|2[0-3]):[0-5]\d:[0-5]\d(?:\.\d+)?(?:Z))$
