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 leaf field gets a confidence score (0–100) or null if no evidence path exists for that field.
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 full nested structure:
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()to extract individual scores. - 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 no evidence: a
nullvalue means no evidence chain exists in the attribution graph — either the value wasn’t found, or it was provided without traceable sourcing. The key is always present infield_confidence(the shape mirrorsstructured_dataexactly).