Data & Agent Docs

Result format

A bounded result separates the entity, answer, supporting evidence, unknowns, limitations and permitted use.

Descriptive format

This initial single-subject result schema is a documentation contract and review format. It is not a live API response, a guaranteed automated serializer or a database export. Scope and delivery are agreed during manual review.

task_type identifies an existing task. status describes evidence completeness, not job execution. entity identifies the company or other organization; result.company is null when company detail is not relevant. as_of is the explicitly recorded assessment time, or null. result contains the answer; evidence binds sources to field paths. unknowns and limitations remain separate from rights.

Null means unknown or unavailable, not false, zero or recently checked. Source-dependent collections may be null when not assessed; an empty list alone does not establish that no relationship exists. No public confidence score or chain-of-thought is provided. Delivered-result use is governed by the agreement; the schema does not grant raw graph redistribution.

Fictional fit-assessment result

Every organization, person, source, date and finding below is fictional. Example.com links are placeholders. This example does not demonstrate a live executed task.

{
  "task_type": "fit-assessment",
  "status": "supported_with_unknowns",
  "as_of": null,
  "entity": {
    "name": "Example Automation Ltd",
    "entity_type": "company",
    "website": "https://example.com"
  },
  "result": {
    "company": {
      "name": "Example Automation Ltd",
      "description": "Industrial automation company",
      "website": "https://example.com",
      "sector": "Industrial automation",
      "subsector": null,
      "location": null,
      "country": "United Kingdom",
      "founded_year": null,
      "employee_count": null,
      "ownership_context": [
        {
          "name": "Example Industrial Holdings",
          "role": "Recorded parent organization",
          "date": null,
          "amount": null,
          "currency": null
        }
      ],
      "people": [
        {
          "name": "Jamie Chen",
          "role": "Chief Executive",
          "date": null,
          "amount": null,
          "currency": null
        }
      ],
      "transactions": [
        {
          "name": "Example Controls Ltd",
          "role": "Acquisition target",
          "date": "2026-09-12",
          "amount": null,
          "currency": null
        }
      ]
    },
    "summary": "The example company meets the supplied location and activity criteria. Beneficial ownership remains unresolved.",
    "criteria": [
      {
        "criterion": "UK operations",
        "assessment": "supported",
        "basis": "Fictional company website describes UK operations."
      },
      {
        "criterion": "Industrial automation",
        "assessment": "supported",
        "basis": "Fictional company website describes industrial automation."
      },
      {
        "criterion": "Beneficial ownership established",
        "assessment": "unknown",
        "basis": "The fictional filing identifies a parent but does not establish ultimate beneficial ownership."
      }
    ]
  },
  "evidence": [
    {
      "field": "result.company.country",
      "source_url": "https://example.com/company",
      "source_type": "official_website",
      "published_at": null,
      "captured_at": null,
      "observed_at": null,
      "verified_at": null,
      "basis": "Fictional website describes UK operations."
    },
    {
      "field": "result.company.sector",
      "source_url": "https://example.com/company",
      "source_type": "official_website",
      "published_at": null,
      "captured_at": null,
      "observed_at": null,
      "verified_at": null,
      "basis": "Fictional website describes industrial automation."
    },
    {
      "field": "result.company.people",
      "source_url": "https://example.com/company",
      "source_type": "official_website",
      "published_at": null,
      "captured_at": null,
      "observed_at": null,
      "verified_at": null,
      "basis": "Fictional website lists Jamie Chen as Chief Executive."
    },
    {
      "field": "result.company.ownership_context",
      "source_url": "https://example.com/filing",
      "source_type": "filing",
      "published_at": "2026-09-12T00:00:00Z",
      "captured_at": null,
      "observed_at": null,
      "verified_at": null,
      "basis": "Fictional filing names the parent organization; it does not identify an ultimate beneficial owner."
    },
    {
      "field": "result.company.transactions",
      "source_url": "https://example.com/filing",
      "source_type": "filing",
      "published_at": "2026-09-12T00:00:00Z",
      "captured_at": null,
      "observed_at": null,
      "verified_at": null,
      "basis": "Fictional filing describes the acquisition of Example Controls Ltd on 12 September 2026; value is undisclosed."
    }
  ],
  "unknowns": [
    "Ultimate beneficial ownership",
    "Current willingness to transact"
  ],
  "limitations": [
    "Fictional example: all names, sources, dates and findings are illustrative, not a customer result.",
    "The format is descriptive; an automated JSON delivery service is not live."
  ],
  "rights": {
    "scope": "A task purchases the agreed bounded result, not database access, unrestricted API queries, contacts export or graph redistribution. Sources and unknowns accompany results. Purchaser authorization, scope acceptance, agreement and payment are required before manual fulfillment; no automated external task service is offered.",
    "raw_graph_access": false,
    "bulk_export": false,
    "graph_redistribution": false
  }
}