OrbitPeople.aidocs

Reading results

Result fields, verdicts, starred contacts, and the project status lifecycle.

Result fields

FieldTypeNotes
resultIdstringStable within a project
fullNamestring
titlestringCurrent job title
companystringCurrent employer
locationstringCity / country
linkedinUrlstring
emailstring | nullWhen available
emailStatus"verified" | "unverified" | nullDeliverability confidence
verdict"relevant" | "irrelevant" | "unknown"
verdictReasonstringWhy this person matches or doesn't
starredbooleanStarred by a user in the Orbit UI
surfacedBystringSearch strategy label — never names a provider

Verdicts

  • relevant — matches the brief. This is the signal you want to act on.
  • irrelevant — surfaced but doesn't match. The reason explains what was off.
  • unknown — not enough data to decide. Review manually; borderline cases land here.

Filter on verdict === "relevant" for your short list. Review "unknown" for edge cases.

Project status lifecycle

StatusdoneMeaning
runningfalseSearch in progress
donetrueComplete
awaiting_inputfalseOrbit has a clarification question
errortrueFailed — error field populated

Counts

{
  "resultCount": 42,
  "relevantCount": 35,
  "irrelevantCount": 5,
  "unknownCount": 2,
  "requestedTarget": 30
}

requestedTarget is the count extracted from the brief if you included a number. relevantCount is the usable signal set.

Pagination

Results are paginated with limit (1–200, default 100) and offset. The SDK's listAllResults(projectId) auto-paginates through all pages.

On this page