# Entity Facts: Sourced & Reconciled

> Entity Facts: Sourced & Reconciled is a paid API for AI agents from mercator-entity-evidence.fly.dev, paid per call via x402, $0.1/call, status unknown (last checked 2026-09-14).

Resolve a company by name or domain and retrieve structured facts with per-field source citations, freshness timestamps, and explicit conflict detection.

## Facts

- Endpoint: POST https://mercator-entity-evidence.fly.dev/v1/entity-evidence
- Price: $0.1/call
- Payment: x402
- Status: unknown
- Last checked: 2026-09-14
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/entity-facts-sourced-reconciled-10b3b58a
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_pBuPPI6ELsh67Lj1NKm40

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability entity-facts-sourced-reconciled-10b3b58a -d '<json body>'
```

Example prompt: Look up Stripe's headquarters, founding year, and key executives — I need field-level source evidence and conflicts flagged, and only use data from the last 60 days.

## When to prefer this

Choose this endpoint when you need structured company facts with explicit provenance — not just a value, but which source it came from, how fresh it is, and whether sources agree. Ideal for due diligence pipelines, CRM enrichment, compliance workflows, or any agent that must show its work when reporting company data. Prefer this over plain web search when you need machine-readable, conflict-aware, timestamped facts rather than raw text.

## Known failure modes

- Company cannot be resolved — ambiguous name with no domain provided, returns low-confidence entity or error
- Requested fields not available in any source — field appears in 'unresolved' list with reason
- Data older than max_age_days — field may be omitted or returned with staleness warning
- Source conflicts detected but no consensus — conflict returned explicitly with differing values
- Rate limit or payment failure — 402 response if x402 payment not attached
- Invalid field enum values — validation error rejecting unknown field names

## How this service works

Evidence-backed company facts and current company information for company enrichment and company verification, with field-level sources, freshness and explicit conflicts.

## Output

A JSON object containing the resolved canonical company entity (name, domain, aliases, confidence), per-field results each with a value, list of source URLs with excerpts and retrieval timestamps, source agreement ratio, and confidence score. Also includes a list of unresolved fields (with reasons), detected conflicts between sources, overall response status (PARTIAL or FULL), a list of all sources consulted, and a response hash for deduplication.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "name": {
   "type": "string",
   "description": "Company name, if no domain is known"
  },
  "domain": {
   "type": "string",
   "description": "Company domain, e.g. stripe.com"
  },
  "fields": {
   "type": "array",
   "items": {
    "enum": [
     "legal_name",
     "primary_domain",
     "headquarters",
     "industry",
     "key_executives",
     "last_reported_funding",
     "founded_year",
     "employee_count"
    ],
    "type": "string"
   },
   "maxItems": 6,
   "minItems": 1
  },
  "max_age_days": {
   "type": "integer",
   "default": 30,
   "maximum": 365,
   "minimum": 1
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "entity": {
   "aliases": [
    "Stripe"
   ],
   "confidence": 0.9,
   "resolved_from": "stripe.com",
   "canonical_name": "Stripe, Inc.",
   "canonical_domain": "stripe.com"
  },
  "fields": {
   "headquarters": {
    "as_of": null,
    "value": "South San Francisco, California",
    "sources": [
     {
      "url": "https://stripe.com/about",
      "states": "South San Francisco, California",
      "excerpt": "Stripe is headquartered in South San Francisco, California",
      "primary": true,
      "source_id": "company_about",
      "origin_class": "self_published",
      "retrieved_at": "2026-08-28T12:00:00Z"
     },
     {
      "url": "https://en.wikipedia.org/wiki/Stripe,_Inc.",
      "states": "South San Francisco",
      "excerpt": "Stripe, Inc. is based in South San Francisco",
      "primary": false,
      "source_id": "wikipedia",
      "origin_class": "third_party",
      "retrieved_at": "2026-08-28T12:00:00Z"
     }
    ],
    "variants": [
     "South San Francisco",
     "South San Francisco, California"
    ],
    "agreement": "2_of_3",
    "confidence": 0.85,
    "match_type": "subsumed",
    "match_basis": "two sources state the same place at different resolutions; the more specific reading is returned and both phrasings are listed",
    "relationship_check": "",
    "oldest_retrieved_at": "2026-08-28T12:00:00Z",
    "relationship_verified": null,
    "relationship_check_outcome": "not_attempted"
   }
  },
  "status": "PARTIAL",
  "billable": true,
  "conflicts": [
   {
    "note": "independent sources disagree; every reading is listed here with its owners and URLs rather than resolved by preference",
    "field": "industry",
    "values": [
     {
      "urls": [
       "https://stripe.com/about"
      ],
      "value": "payment processing",
      "owners": [
       "stripe.com"
      ],
      "excerpt": "Stripe builds payment processing infrastructure"
     },
     {
      "urls": [
       "https://example-register.org/stripe"
      ],
      "value": "financial services",
      "owners": [
       "example-register.org"
      ],
      "excerpt": "\"industryDescription\":\"financial services\""
     }
    ]
   }
  ],
  "unresolved": [
   {
    "field": "last_reported_funding",
    "reason": "no source stated this field"
   }
  ],
  "billing_note": "",
  "reachability": {
   "note": "2 independent sources answered, so agreement above one origin was reachable for this company.",
   "registries": [],
   "
… (truncated)
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/entity-facts-sourced-reconciled-10b3b58a/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from mercator-entity-evidence.fly.dev](https://www.zero.xyz/host/mercator-entity-evidence.fly.dev/llms.txt)