How to enable
Passfield_confidence: true in your /people-intelligence request body:
Response format
When enabled, the response includes afield_confidence object that mirrors the shape of your struct. Each answered field gets its confidence (0–100), a short justification, and the URLs of the pages the value was read on. A field that was not scored is null.
Response fields
When field_confidence is off
The response includes a singleconfidence_score (0–10) at the lead level:
Nested fields (objects and object_lists)
For nested structs,field_confidence mirrors the exact shape of structured_data:
field_confidence structure always matches structured_data recursively. See Response fields for the per-type contract.
Workflow mode
In workflows, field confidence is returned as a singleenrichment_field_confidence column containing a JSON string. The column parses as standard JSON while keeping the CSV flat:
For nested structs, the JSON column contains the same nested structure as the API response above.
To use confidence in downstream workflow blocks, parse the JSON column and filter on the fields you care about, for example on each entry’s
confidence.
Confidence tiers
The 0–100 score maps to named confidence levels:Usage tips
- Parse in code: the
enrichment_field_confidencecolumn (workflow) andfield_confidencefield (API) are both standard JSON. UseJSON.parse()orjson.loads(), then read each entry’sconfidence,justificationandsources. - Threshold by use case: cold email outreach typically accepts 65%+. Legal and compliance work should require 85%+.
- The weakest link dominates: if the target has a very common name, even well-sourced fields score lower because the identity link is uncertain.
- Null means not scored: a
nullentry means the field has no value, or no evidence could be tied to it. The key is always present infield_confidence(the shape mirrorsstructured_dataexactly). - Check a value against its sources:
sourceslists the pages the value was read on, and on xHighnodesnames the findings behind it in the investigation’s graph.