> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sixtyfour.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Confidence Scoring

> Per-field confidence percentages for enrichment results. Understand exactly how reliable each piece of data is.

Field-level confidence provides a 0–100% confidence score for each enrichment field individually, replacing the single lead-level score. The response indicates which fields are reliable and which require verification.

Each score reflects how much assumption is required to connect the field value back to the target person. A high score means the evidence chain is strong; a low score means there's meaningful uncertainty about attribution.

<Warning>
  This feature is in early access. Contact [Sixtyfour Support](mailto:support@sixtyfour.ai) to gain access.
</Warning>

## How to enable

Pass `field_confidence: true` in your `/people-intelligence` request body:

```json theme={null}
{
  "lead_info": {"full_name": "Jane Smith", "company": "Acme Corp"},
  "struct": {
    "email": "Email address",
    "title": "Current job title",
    "linkedin": "LinkedIn profile URL"
  },
  "tier": "high",
  "field_confidence": true
}
```

## Response format

When enabled, the response includes a `field_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`.

```json theme={null}
{
  "notes": "Research complete. Found Jane Smith on LinkedIn and Acme Corp website.",
  "structured_data": {
    "email": "jsmith@acmecorp.com",
    "title": "VP of Engineering",
    "linkedin": "https://www.linkedin.com/in/janesmith-acme/"
  },
  "findings": [],
  "references": {
    "https://linkedin.com/in/janesmith-acme/": "LinkedIn profile"
  },
  "field_confidence": {
    "email": {
      "confidence": 88,
      "justification": "Listed on the Acme Corp team page beside her title.",
      "sources": ["https://acmecorp.com/team"]
    },
    "title": {
      "confidence": 96,
      "justification": "Her LinkedIn profile and the company site both give this title.",
      "sources": ["https://www.linkedin.com/in/janesmith-acme/", "https://acmecorp.com/team"]
    },
    "linkedin": {
      "confidence": 98,
      "justification": "Profile name, employer and photo match the input.",
      "sources": ["https://www.linkedin.com/in/janesmith-acme/"]
    }
  }
}
```

### Response fields

| Field | Type | Description |
| - | - | - |
| `field_confidence` | object | Confidence mirroring the struct shape. Only present when `field_confidence: true` is passed and the org has access. |
| `field_confidence.{field}` | object or null | The field's confidence entry, described below. `null` means the field was not scored, usually because it has no value. |
| `field_confidence.{field}.confidence` | integer (0–100) or null | How sure we are the value is right and belongs to this person. `null` when the value rests only on the input you sent. |
| `field_confidence.{field}.justification` | string | Why the value holds, in a sentence or two. |
| `field_confidence.{field}.sources` | array of URLs | The pages the value was read on. Empty when it came from a source with no public page. |
| `field_confidence.{field}.nodes` | array of strings | xHigh only: the ids of the findings in the investigation's graph that the value rests on. |
| `field_confidence.{object_field}` | object | Same keys as the struct object; each subfield gets its own entry. |
| `field_confidence.{object_list_field}` | array | One object per item in `structured_data`; each subfield gets its own entry. |
| `field_confidence.{list_field}` | object | A list of plain values (`list[str]`) gets one entry for the whole list. |

<Warning>
  When `field_confidence` is present in the response, `confidence_score` is not included. The two fields are mutually exclusive and use different scales: `field_confidence` scores are 0–100 per field, while `confidence_score` is 0–10 at the lead level.
</Warning>

### When field\_confidence is off

The response includes a single `confidence_score` (0–10) at the lead level:

```json theme={null}
{
  "structured_data": {...},
  "confidence_score": 8
}
```

## Nested fields (objects and object\_lists)

For nested structs, `field_confidence` mirrors the exact shape of `structured_data`:

```json theme={null}
{
  "struct": {
    "email": "Email address",
    "company": {
      "name": "Company name",
      "size": "Company size"
    },
    "jobs": [
      {"title": "Job title", "company": "Company name", "start_date": "Start date"}
    ]
  }
}
```

Response:

```json theme={null}
{
  "structured_data": {
    "email": "jsmith@acmecorp.com",
    "company": {"name": "Acme Corp", "size": "500"},
    "jobs": [
      {"title": "VP of Engineering", "company": "Acme Corp", "start_date": "2020"},
      {"title": "Senior Engineer", "company": "Google", "start_date": "2015"}
    ]
  },
  "field_confidence": {
    "email": {"confidence": 88, "justification": "Listed on the team page.", "sources": ["https://acmecorp.com/team"]},
    "company": {
      "name": {"confidence": 96, "justification": "Named on her LinkedIn profile.", "sources": ["https://www.linkedin.com/in/janesmith-acme/"]},
      "size": {"confidence": 45, "justification": "A data aggregator's range, not confirmed elsewhere.", "sources": []}
    },
    "jobs": [
      {
        "title": {"confidence": 95, "justification": "LinkedIn experience section.", "sources": ["https://www.linkedin.com/in/janesmith-acme/"]},
        "company": {"confidence": 95, "justification": "LinkedIn experience section.", "sources": ["https://www.linkedin.com/in/janesmith-acme/"]},
        "start_date": {"confidence": 60, "justification": "Year inferred from a 2020 announcement.", "sources": ["https://acmecorp.com/news/2020"]}
      },
      {
        "title": {"confidence": 72, "justification": "An older conference bio.", "sources": ["https://example-conf.com/speakers"]},
        "company": {"confidence": 72, "justification": "An older conference bio.", "sources": ["https://example-conf.com/speakers"]},
        "start_date": null
      }
    ]
  }
}
```

The `field_confidence` structure always matches `structured_data` recursively. See [Response fields](#response-fields) for the per-type contract.

## Workflow mode

In workflows, field confidence is returned as a single `enrichment_field_confidence` column containing a JSON string. The column parses as standard JSON while keeping the CSV flat:

| name | email | enrichment\_field\_confidence |
| - | - | - |
| Jane Smith | [jsmith@acme.com](mailto:jsmith@acme.com) | `{"email": {"confidence": 88, "justification": "...", "sources": ["..."]}, ...}` |

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:

| Range | Level | What it means |
| - | - | - |
| 85–100% | Confirmed | Near-zero assumption. Unique identifiers, direct assertions from authoritative sources. |
| 65–84% | Established | Minimal assumption. A careful person would rely on this. One small residual uncertainty. |
| 40–64% | Supported | Moderate assumption. The identity or value link is reasonable but not tight. |
| 15–39% | Speculative | Significant assumption. Weak identifiers, multiple possible matches. Treat as hypothesis. |
| 0–14% | Unreliable | Major assumption or conflicting evidence. Do not rely on. |

## Usage tips

* Parse in code: the `enrichment_field_confidence` column (workflow) and `field_confidence` field (API) are both standard JSON. Use `JSON.parse()` or `json.loads()`, then read each entry's `confidence`, `justification` and `sources`.
* 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 `null` entry means the field has no value, or no evidence could be tied to it. The key is always present in `field_confidence` (the shape mirrors `structured_data` exactly).
* Check a value against its sources: `sources` lists the pages the value was read on, and on xHigh `nodes` names the findings behind it in the investigation's graph.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.