Vaquill AI · Schema

FactSet

One generated ledger.

LegalStatutesRegulationsLegal ResearchLawComplianceLegal TechGovernment DataMCPIndiaContracts

Properties

Name Type Description
id string `fct_` identifier. The same id the operation's resource carries.
matterId string The `mat_` matter this set covers.
status object The generation's status, in the same five values every operation uses.
mode string How this set was generated. `standard` re-reads the matter, `incremental` reads only what changed. Sets generated from the web app may report `deep`, which this API does not accept.
isCurrent boolean True for the one set in force for this matter. Generating a new set makes the previous one `false`; nothing is deleted, and its facts stay readable.
isStale boolean True when the matter's documents have changed since this set was built. Computed per request against the current document set, never stored.
changedDocCount integer How many documents the matter has gained since this set was generated. Zero with `isStale` true means documents were re-ingested rather than added.
coverage object What the generation read.
factCount object Facts in the set, once it has finished.
conflictCount object Facts the reducer flagged as conflicted.
createdAt string When the generation was requested.
completedAt object When the generation finished. Null until it does.
View JSON Schema on GitHub

JSON Schema

vaquill-ai-fact-set-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/vaquill-ai/json-schema/vaquill-ai-fact-set-schema.json",
  "title": "FactSet",
  "description": "One generated ledger.",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/vaquill-ai-facts-api-openapi.yml#/components/schemas/FactSet",
  "properties": {
    "id": {
      "type": "string",
      "title": "Id",
      "description": "`fct_` identifier. The same id the operation's resource carries."
    },
    "matterId": {
      "type": "string",
      "title": "Matterid",
      "description": "The `mat_` matter this set covers."
    },
    "status": {
      "$ref": "#/$defs/OperationStatus",
      "description": "The generation's status, in the same five values every operation uses."
    },
    "mode": {
      "type": "string",
      "title": "Mode",
      "description": "How this set was generated. `standard` re-reads the matter, `incremental` reads only what changed. Sets generated from the web app may report `deep`, which this API does not accept."
    },
    "isCurrent": {
      "type": "boolean",
      "title": "Iscurrent",
      "description": "True for the one set in force for this matter. Generating a new set makes the previous one `false`; nothing is deleted, and its facts stay readable."
    },
    "isStale": {
      "type": "boolean",
      "title": "Isstale",
      "description": "True when the matter's documents have changed since this set was built. Computed per request against the current document set, never stored."
    },
    "changedDocCount": {
      "type": "integer",
      "title": "Changeddoccount",
      "description": "How many documents the matter has gained since this set was generated. Zero with `isStale` true means documents were re-ingested rather than added."
    },
    "coverage": {
      "$ref": "#/$defs/FactSetCoverage",
      "description": "What the generation read."
    },
    "factCount": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Factcount",
      "description": "Facts in the set, once it has finished."
    },
    "conflictCount": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Conflictcount",
      "description": "Facts the reducer flagged as conflicted."
    },
    "createdAt": {
      "type": "string",
      "format": "date-time",
      "title": "Createdat",
      "description": "When the generation was requested."
    },
    "completedAt": {
      "anyOf": [
        {
          "type": "string",
          "format": "date-time"
        },
        {
          "type": "null"
        }
      ],
      "title": "Completedat",
      "description": "When the generation finished. Null until it does."
    }
  },
  "additionalProperties": false,
  "type": "object",
  "required": [
    "id",
    "matterId",
    "status",
    "mode",
    "isCurrent",
    "isStale",
    "changedDocCount",
    "coverage",
    "createdAt"
  ],
  "$defs": {
    "FactSetCoverage": {
      "properties": {
        "included": {
          "type": "integer",
          "title": "Included",
          "description": "Documents whose evidence went into this set."
        },
        "total": {
          "type": "integer",
          "title": "Total",
          "description": "Documents in the matter at generation time."
        },
        "excluded": {
          "type": "integer",
          "title": "Excluded",
          "description": "Documents in the matter that this generation did not read, because it hit the per-run inline ceiling. Generate again to pick up more."
        }
      },
      "additionalProperties": false,
      "type": "object",
      "required": [
        "included",
        "total",
        "excluded"
      ],
      "title": "FactSetCoverage",
      "description": "What the generation actually read, and what it did not.\n\nNot decoration. The reducer extracts at most 60 documents inline, so on a\nlarger matter `included` is 60 and `excluded` is the rest, while the\noperation reports 60 of 60 and looks complete. It IS complete, for what it\nread. This is the only place that says what that was."
    },
    "OperationStatus": {
      "type": "string",
      "enum": [
        "queued",
        "running",
        "succeeded",
        "failed",
        "cancelled"
      ],
      "title": "OperationStatus",
      "description": "The public five. There is no sixth, and there are no synonyms.\n\nInternal vocabularies spell terminal success `completed`, `ready`,\n`extracted`, `succeeded` and `fresh`; terminal failure `failed` and `error`;\nqueued `pending`, `queued` and `draft`. All of that is collapsed here by\n`app.workspace_api.adapters.status_map`, which refuses to guess."
    }
  }
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/vaquill-ai-fact-set"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.