All answers
How it works

What should a relationship research API return?

A useful relationship research API should return stable identities, role history, connection type, supporting evidence, freshness, confidence and validation status. For access tasks, add the proposed path and next step. A relationship score alone is insufficient: developers need to understand what the data establishes, what is inferred and which actions are authorised.
October 8, 2026

Separate the entities and evidence

Keep people, organisations and dated roles distinct. Attach evidence to the specific relationship rather than hiding it inside a summary. Preserve source references and identity-resolution uncertainty.

Describe path limitations

For each route, show intermediary people, evidence for each link and whether a connector has confirmed suitability. Do not label a whole chain verified because one edge is known.

Design for safe consumption

Return only information the caller can access. Include clear empty, stale, ambiguous and error states. Reading a path should not also trigger outreach.

Test realistic failures

Use similar names, changed employers, missing sources and denied access. Compare results against known relationships before relying on ranking at scale.

This is a suggested evaluation schema, not a statement of Orbb's current endpoint fields. Request current documentation for Orbb's API or MCP offering and test the actual contract before implementing against it.

Related questions

Orbb researches the relationships your company already has — across customers, employees, investors and partners — then runs the introduction end to end, from finding the path to the meeting in the calendar.
See it on your own accounts