List the people who could introduce someone to a person
Body: { "target": … }, plus the optional fields below.
Lists the people connected to target, strongest first, a page at a time: the people who could make an introduction to target. The answer has the shape of a circle answer, with target as its subject.
Paths takes no min_strength: every connection is listed, page by page.
Checked in order: the body (400 invalid_body), limit, cursor, types, max_tokens; with on_miss: RESEARCH only, the research and resolve jobs still running (429 research_busy); then, for every call, the balance (402).
See also /v1/circle, Jobs, Billing, Rate limits.
Authorizations
Body
Names the person to reach, in the forms /v1/circle’s id takes. Spaces around it are ignored; a blank value is answered 400 invalid_body. A target no person matches is answered 404 person_not_found; one that several people have held, 422 ambiguous_person with candidates.
See also /v1/circle, /v1/resolve.
1 - 512Restricts the answer to these connection types: CAREER (worked at the same company at the same time), EDUCATION (studied at the same school), INVESTOR (held investor roles at the same companies), LINKEDIN_COMMENTS (one commented on the other’s LinkedIn post). An empty array, or a member that is not a connection type, is answered 400 invalid_types.
A type listed twice counts once. With on_miss: RESEARCH, only the listed types are researched.
See also on_miss.
Default: every type.
1 - 64 elementsCAREER, EDUCATION, INVESTOR, LINKEDIN_COMMENTS 64Sets the maximum number of people returned in one answer. A value outside the range, or one that is not an integer, is answered 400 invalid_limit.
When more people match, the answer carries next_cursor; pass it as cursor with the same body to read the next page. People are ordered by strength, strongest first.
See also cursor.
1 <= x <= 100Continues a listing from the previous answer’s next_cursor, with the rest of the body unchanged. Absent or blank reads the first page. A value that does not decode as a cursor is answered 400 invalid_cursor.
A cursor is a position in the order, not a query: one from another query, or with other types or min_strength, is not refused and starts at that position in the new order.
Each page reads the data as it stands at that call, so a connection whose strength changed between pages can be listed twice or not at all.
See also limit, next_cursor.
512Sets what happens to a requested type not yet researched for the people asked about. UNKNOWN answers from what is known and reports the type in the answer’s coverage; RESEARCH researches the requested types first, then answers. Any other value is answered 400 invalid_body.
RESEARCH takes longer, and is more often answered 202 with a job to read through /v1/job. A type researched recently is mostly not researched again; on circle and paths, force researches it anyway.
See also max_tokens, force, /v1/job, Jobs, Billing, Rate limits.
UNKNOWN, RESEARCH Sets the tokens reserved for research on top of the call’s price. Taken only with on_miss: RESEARCH: with any other on_miss, even within the range, it is answered 400 invalid_max_tokens; so is a value outside the range, or one with more than 3 decimals.
The range starts above zero: to research nothing, leave out RESEARCH.
See also on_miss, Billing.
Default: 2 with on_miss: RESEARCH.
0.001 <= x <= 600Response
A page of the people connected to target.