Fuentio API outcomes

Every answer about a company carries meta.outcome, one of these nine states, on every REST endpoint and MCP tool; errors carry it as error.outcome.

A registry check is not full KYB, UBO proof, sanctions clearance or a guarantee that a company is safe to deal with.

OutcomeMeansDoes NOT mean
verifiedThe named official source states what is returned, as of last_verified_at, within the freshness rule given in meta.freshness.Not full KYB, UBO proof, sanctions clearance or a judgement that the company is safe to deal with: only what that source states.
partialPart of the answer rests on the source; the rest is missing, not covered or not checked, and the reasons say which.Not a failed check and not verified either: read the reasons before relying on it.
unverifiedThe source answered, but it doesn't confirm what was asked (for example: the company is ceased, the address isn't in the official address base, a VAT number's registration isn't checked).Not "the company doesn't exist" and not a finding of fraud: only that this check didn't confirm it.
status_unknownThe company is in the source, but the source states no current status (Spain: no act about its status in BORME since 2009).Neither active nor ceased: unknown. Don't treat it as either.
not_foundThe identifier is valid and inside Fuentio's coverage, and the official source has no record of it.Not proof that the company never existed: France leaves out units that opted out of public diffusion.
not_coveredThe country, identifier type, data or period isn't covered, so Fuentio can't say (Spain: a company with no BORME act since 2 January 2009).Not "not found" and not "no": it is outside what Fuentio covers.
ambiguousSeveral companies could match: candidates come with their match reasons and a match band (exact, strong, possible, insufficient).Not a match: pick one by its official ID before relying on it. A name alone never links two records.
staleA stored copy is returned because the source couldn't be reached or refreshed; it is older than the freshness rule allows.Not the source's current state: check last_verified_at and retry later.
source_unavailableThe official source didn't answer and Fuentio holds nothing usable for this question; retry after retry_after seconds.Not "not found": the question is unanswered for now.

When several apply, the first in this order wins: source_unavailable, stale, not_found, not_covered, ambiguous, status_unknown, unverified, partial, verified.

meta.freshness: source_published_at, retrieved_at, last_verified_at, from_cache, stale and the rule applied. Errors: /docs/errors. Guide for AI agents: /llms.txt.