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.
| Outcome | Means | Does NOT mean |
|---|---|---|
verified | The 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. |
partial | Part 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. |
unverified | The 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_unknown | The 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_found | The 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_covered | The 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. |
ambiguous | Several 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. |
stale | A 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_unavailable | The 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.