Skip to main content
POST
People Intelligence (Sync)

Authorizations

x-api-key
string
header
required

Your Sixtyfour API key.

Body

application/json

dispatch_id and exclusive_run act only on async runs; sent to the sync route, they are ignored.

lead_info
Lead Info · object
required

The person to look up: any combination of name, email, company, linkedin and other known details.

struct
Struct · object | null

Fields to return: output field name to a description of what to find. An image field returns a https://api.sixtyfour.ai/v1/media/... URL you can embed. Required except on Atlas runs (xhigh, or scout with graph).

research_plan
string | null

A plan, in plain language, that guides the research. Default: none.

Maximum string length: 100000
tier
enum<string> | null

Research depth and price. See Credits & Pricing. Default: low.

Available options:
low,
micro,
medium,
high,
xhigh,
scout
webhook_url
string<uri> | null

HTTPS URL that receives the result when the job completes. Default: none.

Required string length: 1 - 2048
field_confidence
boolean | null

If true, returns each requested field's confidence (0-100), justification and source URLs, nested like the request. Default: false.

graph
boolean | null

scout only. If true, runs Scout as an Atlas investigation, billed per unit of research. It enables the Atlas run options (max_credits, max_minutes, relentless, investigation_id, investigation_name, include_workspace), makes struct optional, and the async response returns the investigation. Requires Scout in Atlas for your organization. If false or omitted, Scout runs as usual.

include_workspace
boolean | null

Atlas runs only. If true, includes the investigation's workspace files in the result; they are read from the investigation, so they include later runs' changes. Default: true.

investigation_id
string | null

Atlas runs only: continues this investigation, reusing its graph and workspace, instead of creating one. Default: creates one.

Maximum string length: 200
investigation_name
string | null

Atlas runs only: the title of a new investigation. Ignored with investigation_id. Default: taken from lead_info.

Maximum string length: 1000
private
boolean
default:false

If true, shows the run's result, status and usage log only to you (with an API key, to the key's creator). Your team must allow private runs. Atlas runs need the async endpoint and a new investigation.

connections
string[] | null

Your team's connected APIs the run's agents may call, by name. Leave it out to allow all of them; an empty list allows none. Taken by xhigh, by scout with graph, and by high; refused on other tiers.

Maximum array length: 10
Maximum string length: 63
relentless
boolean
default:false

Atlas runs with struct only. If true, researches until the budget runs out. If false, a run may stop once every requested field is answered, and is charged for the research it used (at least one unit). Default: false.

agent_trace
boolean
default:false

Atlas runs only. If true, the investigation's Agents tab in Atlas shows a short, readable summary of each agent's reasoning and actions as it works. The trace is for people reading along: it does not change the research or the results. Leave it off when you only read results through the API. Default: false.

generate_report
boolean
default:false

Atlas runs only. If true, starts the investigation's PDF intelligence report when research completes. You can also generate one at any time with POST /investigations/{investigation_id}/report or from the Report tab in Atlas. Default: false.

max_credits
integer | null

Atlas runs only: research budget in credits, from one to 10 units of the tier price. Default: one unit. The whole budget is used and charged unless the run stops early (see relentless and max_minutes).

max_minutes
integer | null

Atlas runs only: the most minutes of research time; waiting to retry does not count. When reached, the run writes up its findings, which can take a few minutes, and is charged only for the research it used. Default: no limit.

Required range: 10 <= x <= 1440
skills
string[] | null

Skills the run's agents follow, by name: team/<name> for one of your team's skills, sixtyfour/<name> for one of ours. Up to 25,000 tokens in total. Taken by xhigh, by scout with graph, and by high; refused on other tiers.

Required string length: 1 - 74

Response

Successful Response

structured_data
Structured Data · object
required

Requested enrichment fields and extracted values.

confidence_score
number

Overall confidence in the result, from 0 (nothing useful found) to 10 (every field filled and cross-checked).

Required range: 0 <= x <= 10
references
References · object | null

Source references used to produce the result.

notes
string | null

Human-readable notes about the enrichment result.

findings
any[] | null

Optional supporting findings produced by the enrichment agent.

field_confidence
Field Confidence · object | null

Per requested field, nested like the request: its confidence (0-100), justification and sources. xHigh also names the research graph nodes the value rests on.

investigation_id
string | null
deprecated

Deprecated compatibility field. Use the response envelope's investigation.id.