{"uid":"cap_BKRyN6HHxuMBfxNBVjd48","slug":"mercator-verify-entity-evidence-lookup-25bb402b","name":"MERCATOR Verify Entity Evidence Lookup","description":"MERCATOR Verify provides evidence-backed verification and decision support for autonomous agents. Use its specialized tools when an agent needs trustworthy evidence before taking a downstream action.","url":"https://mercator-entity-evidence.fly.dev/v1/entity-evidence/lookup","method":"GET","headers":{},"bodySchema":{"type":"object","required":["company"],"properties":{"company":{"type":"string","description":"Company domain or name, e.g. `cloudflare.com` or `Cloudflare`."}}},"responseSchema":{"type":"object","title":"EntityEvidenceResponse","required":["status"],"properties":{"entity":{"anyOf":[{"type":"object","title":"ResolvedEntity","required":["canonical_domain","resolved_from","confidence"],"properties":{"aliases":{"type":"array","items":{"type":"string"},"title":"Aliases","default":[]},"confidence":{"type":"number","title":"Confidence","maximum":1,"minimum":0},"resolved_from":{"type":"string","title":"Resolved From","minLength":1},"canonical_name":{"type":"string","title":"Canonical Name","default":""},"canonical_domain":{"type":"string","title":"Canonical Domain"}},"additionalProperties":false},{"type":"null"}],"default":null},"fields":{"type":"object","title":"Fields","additionalProperties":{"type":"object","title":"FieldEvidence","required":["value","confidence","agreement","sources","oldest_retrieved_at"],"properties":{"as_of":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"As Of","default":null},"value":{"title":"Value"},"sources":{"type":"array","items":{"type":"object","title":"SourceExcerpt","required":["url","excerpt","retrieved_at","source_id"],"properties":{"url":{"type":"string","title":"Url","minLength":1},"states":{"title":"States","default":null},"excerpt":{"type":"string","title":"Excerpt","maxLength":1000,"minLength":1},"primary":{"type":"boolean","title":"Primary","default":false},"source_id":{"type":"string","title":"Source Id","minLength":1},"origin_class":{"type":"string","title":"Origin Class","default":""},"retrieved_at":{"type":"string","title":"Retrieved At","format":"date-time"}},"description":"One piece of checkable evidence.\n\n`excerpt` is verbatim text that was VERIFIED to occur in the fetched document. It is not\na summary and never a paraphrase: a buyer must be able to open the URL, search for the\nstring, and find it. That is the entire product.","additionalProperties":false},"title":"Sources","minItems":1},"variants":{"type":"array","items":{"type":"string"},"title":"Variants","default":[]},"agreement":{"type":"string","title":"Agreement","pattern":"^\\d+_of_\\d+$"},"confidence":{"type":"number","title":"Confidence","maximum":1,"minimum":0},"match_type":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Match Type","default":"exact"},"match_basis":{"type":"string","title":"Match Basis","default":""},"relationship_check":{"type":"string","title":"Relationship Check","default":""},"oldest_retrieved_at":{"type":"string","title":"Oldest Retrieved At","format":"date-time"},"relationship_verified":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Relationship Verified","default":null},"relationship_check_outcome":{"type":"string","title":"Relationship Check Outcome","default":"not_attempted"}},"description":"One answered field: the value and everything needed to check it.","additionalProperties":false}},"status":{"enum":["SUCCESS","PARTIAL","UNRESOLVED","INSUFFICIENT_EVIDENCE"],"type":"string","title":"ResolutionStatus"},"billable":{"type":"boolean","title":"Billable","default":true},"conflicts":{"type":"array","items":{"type":"object","title":"FieldConflict","required":["field","values"],"properties":{"note":{"type":"string","title":"Note","default":""},"field":{"type":"string","title":"Field"},"values":{"type":"array","items":{"type":"object","additionalProperties":true},"title":"Values","minItems":2}},"description":"Sources that disagree. Returned, never resolved by preference alone.","additionalProperties":false},"title":"Conflicts","default":[]},"unresolved":{"type":"array","items":{"type":"object","title":"UnresolvedField","required":["field","reason"],"properties":{"field":{"type":"string","title":"Field"},"reason":{"type":"string","title":"Reason"}},"description":"A field nobody could evidence. Not an error — an honest answer.","additionalProperties":false},"title":"Unresolved","default":[]},"billing_note":{"type":"string","title":"Billing Note","default":""},"reachability":{"anyOf":[{"type":"object","title":"Reachability","required":["independent_origins"],"properties":{"note":{"type":"string","title":"Note","default":""},"registries":{"type":"array","items":{"type":"string"},"title":"Registries","default":[]},"single_origin":{"type":"boolean","title":"Single Origin","default":false},"origin_classes":{"type":"array","items":{"type":"string"},"title":"Origin Classes","default":[]},"own_site_answered":{"type":"boolean","title":"Own Site Answered","default":false},"registries_absent":{"type":"array","items":{"type":"string"},"title":"Registries Absent","default":[]},"independent_origins":{"type":"integer","title":"Independent Origins","minimum":0},"single_origin_fields":{"type":"array","items":{"type":"string"},"title":"Single Origin Fields","default":[]},"single_origin_field_reason":{"type":"string","title":"Single Origin Field Reason","default":""}},"description":"What this entity could EVER be corroborated by. The ceiling, stated.\n\nFour of seven exchanges measured on 2026-08-30 are structurally single-origin: not an\nSEC registrant, no LEI record, own site blocked or empty. No field of theirs can reach\ntwo independent origins however well the extractor works — and today that arrives as a\n`1_of_1` a buyer's independence gate cannot tell from a shortfall.\n\nA gate can branch on a stated ceiling; it cannot branch on a silent one. Same principle\nas returning conflicts instead of resolving them quietly.","additionalProperties":false},{"type":"null"}],"default":null},"response_hash":{"type":"string","title":"Response Hash","default":""},"source_outcomes":{"type":"array","items":{"type":"object","title":"SourceOutcomeReport","required":["source_id","outcome"],"properties":{"url":{"type":"string","title":"Url","default":""},"detail":{"type":"string","title":"Detail","default":""},"reason":{"type":"string","title":"Reason","default":""},"outcome":{"type":"string","title":"Outcome","minLength":1},"source_id":{"type":"string","title":"Source Id","minLength":1}},"description":"One consulted source, and whether it answered.\n\n`outcome` is \"succeeded\", \"failed\" or \"not_attempted\". `reason` is a small closed\nvocabulary a gate can branch on without parsing prose: \"http_status\", \"transport\",\n\"empty_document\", \"budget_exhausted\", \"not_applicable\". `detail` is for a human.","additionalProperties":false},"title":"Source Outcomes","default":[]},"sources_consulted":{"type":"array","items":{"type":"string"},"title":"Sources Consulted","default":[]},"informative_fields":{"type":"array","items":{"type":"string"},"title":"Informative Fields","default":[]}},"description":"What the buyer gets. `response_hash` covers everything above it.","additionalProperties":false},"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_YNrvuiONdi1Vs5_red-Fs","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":"Retrieves evidence-backed, source-cited facts about a company entity given a domain or company name, returning structured fields with confidence scores and verbatim source excerpts.","exampleAgentPrompt":"Can you pull up evidence-backed facts about Stripe — I need verified, source-cited information including their canonical domain and confidence scores before I proceed with onboarding them?","exampleUseCases":[{"title":"Pre-onboarding vendor due diligence","prompt":"Before we sign a contract with this vendor, can you verify key facts about Brex — pull their canonical domain, any known aliases, and show me the actual source excerpts that back up what you find?"},{"title":"Autonomous agent trust gate","prompt":"My agent is about to wire funds to a counterparty claiming to be Cloudflare — can you get evidence-backed verification of cloudflare.com with confidence scores so I can decide whether to proceed?"},{"title":"Company identity resolution","prompt":"I have a company listed as 'Anthropic AI' in our CRM — can you resolve their canonical domain and name with source citations so I know we have the right entity on file?"}],"resultDescription":"Returns a structured object containing: a resolved entity block with the canonical domain, canonical name, aliases, and resolution confidence; plus a fields map where each field (e.g. headquarters, founding year, employee count) carries a value, a confidence score, an agreement score across sources, and an array of source excerpts — each excerpt being verbatim text found at a checkable URL with a retrieval timestamp.","failureModes":["Company name is ambiguous and cannot be resolved to a unique entity — entity block returns null","No evidence found for requested fields — fields map returns empty or low-confidence values","Domain or company name is misspelled or does not exist — status indicates not found","Rate limit or payment failure due to x402 payment not being processed — 402 response","Partial evidence: some fields populated with sources, others missing — agent must handle sparse responses"],"whenToPreferThis":"Choose MERCATOR Verify when an agent requires trustworthy, citation-backed company facts before taking a consequential downstream action (e.g. payment, contract, onboarding). It is specifically valuable when confidence scores and verbatim source excerpts are needed to audit or justify a decision, not just a raw data lookup. Prefer this over generic company data APIs when verifiability and evidence provenance matter more than data breadth.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T00:30:39.876Z","isFirstParty":false}