Reading results
Result fields, verdicts, starred contacts, and the project status lifecycle.
Result fields
| Field | Type | Notes |
|---|---|---|
fullName | string | null | |
firstName | string | null | |
lastName | string | null | |
title | string | null | Current job title |
company | string | null | Current employer |
location | string | null | City / country |
linkedinUrl | string | null | |
primaryEmail | string | null | When one was found |
primaryPhone | string | null | When one was found |
surfacedBy | string | Which of Orbit's searches found this person; several are joined with · |
starred | boolean | Starred by someone in your workspace in the Orbit app |
fields | object | Extra details found for this person, keyed by a readable label |
verdicts | object | One entry per criterion from your brief: "yes" or "no". A criterion not yet checked, or that couldn't be decided, is absent |
Verdicts
Orbit turns your brief into criteria — "payments experience", "based in Berlin" — and checks each person against them. verdicts carries the answer per criterion:
{ "Payments experience": "yes", "Based in Berlin": "yes" }A person who matches every criterion is your short list. A criterion missing from verdicts hasn't been checked yet, or couldn't be decided from what Orbit found — once the search is done, treat it as unknown.
Project status lifecycle
status | done | Meaning |
|---|---|---|
running | false | Search in progress |
done | true | Finished — including with nobody found — or the target count in your brief was reached |
awaiting_input | false | Orbit couldn't act on the brief as written — see clarificationQuestion, then submit a new brief |
If something went wrong, error carries a short explanation; otherwise it is null.
Counts
{
"totalResults": 42,
"verifiedResults": 35,
"requestedTarget": 30,
"starredResults": 0
}totalResults is everyone found so far; verifiedResults is how many matched your criteria. requestedTarget is the count from your brief if you included one ("find 30 …") — the search is done once verifiedResults reaches it.
Pagination
Page with limit (1–200, default 100) and offset (default 0) until you have total rows. Wait for done before paging if you need a stable set — a running search is still adding people.