{"uid":"cap_pBuPPI6ELsh67Lj1NKm40","slug":"entity-facts-sourced-reconciled-10b3b58a","name":"Entity Facts: Sourced & Reconciled","description":"Evidence-backed company facts and current company information for company enrichment and company verification, with field-level sources, freshness and explicit conflicts.","url":"https://mercator-entity-evidence.fly.dev/v1/entity-evidence","method":"POST","headers":{},"bodySchema":{"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}}},"responseSchema":{"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":[],"single_origin":false,"origin_classes":["self_published","third_party"],"own_site_answered":true,"registries_absent":["gleif_lei","sec_submissions","sec_proxy"],"independent_origins":2,"single_origin_fields":[],"single_origin_field_reason":""},"response_hash":"…","source_outcomes":[{"url":"https://stripe.com/about","detail":"","reason":"","outcome":"succeeded","source_id":"company_about"},{"url":"https://stripe.com/company","detail":"404","reason":"http_status","outcome":"failed","source_id":"company_company"}],"sources_consulted":["company_about","company_site","wikipedia"],"informative_fields":["headquarters"]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_8WUg6B6SCGlnSanmFedTm","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.1","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolve a company by name or domain and retrieve structured facts with per-field source citations, freshness timestamps, and explicit conflict detection.","exampleAgentPrompt":"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.","exampleUseCases":[{"title":"Due diligence fact-check on a startup","prompt":"I'm evaluating a potential investment in a company called 'Cohere AI' — can you pull their legal name, headquarters, last reported funding, and employee count with source citations and flag any data conflicts? Only use facts from the last 90 days."},{"title":"Enriching a CRM record with verified data","prompt":"I have a lead from stripe.com in our CRM and I need to enrich it with their legal name, industry, and headquarters. Make sure to include where each fact came from and how fresh the data is."},{"title":"Competitive intelligence research","prompt":"For my competitor analysis on openai.com, fetch their founding year, key executives, and industry classification — I want to see all the sources consulted and any disagreements between them, using data no older than 30 days."}],"resultDescription":"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.","failureModes":["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"],"whenToPreferThis":"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.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:38:10.695Z","isFirstParty":false}