Licium · Schema
ReceivedWorkCheckEnvelope
CompanyHealthcareSoftware-as-a-ServiceCredentialingAutomation
Properties
| Name | Type | Description |
|---|---|---|
| success | boolean | |
| data | object |
JSON Schema
{
"$schema": "https://json-schema.org/draft/2020-12/schema",
"$id": "https://artifacts.apis.io/licium-ai/json-schema/licium-ai-received-work-check-envelope-schema.json",
"title": "ReceivedWorkCheckEnvelope",
"x-generated": "2026-11-15",
"x-method": "derived",
"x-generator": "derive-json-schema.py",
"x-source": "openapi/licium-ai-openapi.json#/components/schemas/ReceivedWorkCheckEnvelope",
"type": "object",
"required": [
"success",
"data"
],
"properties": {
"success": {
"type": "boolean",
"const": true
},
"data": {
"type": "object",
"required": [
"report",
"criteria",
"allowance",
"criteria_origin",
"criteria_grade",
"criteria_origin_label"
],
"properties": {
"criteria_origin": {
"type": "string",
"const": "checker"
},
"criteria_grade": {
"type": "null"
},
"criteria_origin_label": {
"type": "string",
"const": "Criteria set by the person who ran this check"
},
"report": {
"type": "object",
"required": [
"headline",
"verdict",
"criteria",
"honesty",
"source_reverification",
"observations"
],
"properties": {
"criteria_origin": {
"type": "string",
"const": "checker"
},
"criteria_grade": {
"type": "null"
},
"criteria_origin_label": {
"type": "string",
"const": "Criteria set by the person who ran this check"
},
"headline": {
"type": "string"
},
"verdict": {
"type": "string",
"enum": [
"pass",
"fail",
"could_not_verify"
]
},
"criteria": {
"type": "array",
"items": {
"$ref": "#/$defs/CriterionResult"
}
},
"honesty": {
"type": "object",
"required": [
"passed",
"marked_unknowns",
"silent_unknowns",
"marked_unknown_locators",
"silent_unknown_locators",
"notes"
],
"properties": {
"passed": {
"type": "boolean"
},
"marked_unknowns": {
"type": "integer",
"minimum": 0
},
"silent_unknowns": {
"type": "integer",
"minimum": 0
},
"marked_unknown_locators": {
"type": "array",
"maxItems": 20,
"items": {
"$ref": "#/$defs/CheckLocator"
}
},
"silent_unknown_locators": {
"type": "array",
"maxItems": 20,
"items": {
"$ref": "#/$defs/CheckLocator"
}
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"additionalProperties": false
},
"source_reverification": {
"type": "object"
},
"source_reachability": {
"type": "object",
"required": [
"sampled",
"responded"
],
"properties": {
"sampled": {
"type": "integer",
"minimum": 0
},
"responded": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
"observations": {
"type": "array",
"maxItems": 10,
"items": {
"$ref": "#/$defs/CheckObservation"
},
"description": "Observations outside the criteria: things the checker noticed that no criterion asked about (duplicate rows, identical values, empty columns, mixed formats, stale, future or contradictory dates, unreachable or unsupporting sources). If every sampled source is unavailable, the receipt verdict is could_not_verify (Could not verify), without a rework offer. A partial outage keeps the existing behavior. Independent failed criteria still fail. Pinned payment gates keep their agreed criteria. Checker receipts return criteria_origin=checker, criteria_grade=null, and criteria_origin_label: Criteria set by the person who ran this check. The checker samples on /check include passing Vendor terms and Meeting notes, and a Supplier catalog with two duplicate rows that fails its declared no-duplicate criterion and offers rework. Checker runs carry no source grade letter; source grades apply only to bounty gates. Existing saved receipts receive this attribution when read. The checker result and receipt display the top-level criteria_origin_label without a grade letter or grade scale when criteria_grade is null. Rerun verdicts preserve pass, fail, or could_not_verify for both the saved and current receipt. Other observations do not change criteria results or payment. Each carries suggested_criterion, one plain sentence you can add to the next check's criteria."
},
"rework": {
"type": "object",
"description": "Present only when verdict is fail; contains one web action, an intact criteria prefill, and api: the exact POST /v1/bounties body (flavor received_work_rework, rework_criteria) an agent sends after adding amount_usd and its agent key or email."
},
"settlement": {
"type": "object",
"description": "Present on a failed report while held payments are on and every check can release one: hold the payment until a delivery passes these same checks. Send body (criteria) to settlement action create (POST /v1/settlements) with what needs lists: amount_usd (1 to 1000), deadline_days (3 to 30), an Idempotency-Key, and an agent key (x402 or balance) or a signed-in session.",
"required": [
"message",
"tool",
"action",
"method",
"href",
"body",
"needs"
],
"properties": {
"message": {
"type": "string"
},
"tool": {
"type": "string",
"const": "settlement"
},
"action": {
"type": "string",
"const": "create"
},
"method": {
"type": "string",
"const": "POST"
},
"href": {
"type": "string",
"const": "/v1/settlements"
},
"body": {
"type": "object",
"required": [
"criteria"
],
"properties": {
"criteria": {
"type": "array",
"items": {
"$ref": "#/$defs/AcceptanceCriterion"
}
}
}
},
"needs": {
"type": "array",
"items": {
"type": "string"
}
}
}
}
},
"additionalProperties": true
},
"criteria": {
"type": "array",
"items": {
"$ref": "#/$defs/AcceptanceCriterion"
}
},
"check_pack_slug": {
"type": "string",
"description": "Exact pack slug used for this check."
},
"check_pack_version": {
"type": "integer",
"minimum": 1,
"description": "Exact pack version used for this check."
},
"allowance": {
"type": "object"
},
"rerun": {
"type": "object",
"description": "Present when report_token re-applied a saved report's criteria. Compares this verdict with the saved one using check ids only: fixed, newly_failed, still_failing, and failed_before/failed_now counts. No delivery content.",
"properties": {
"previous_report": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{43}$"
},
"previous_as_of": {
"type": "string",
"format": "date-time"
},
"previous_verdict": {
"type": "string",
"enum": [
"pass",
"fail",
"could_not_verify"
]
},
"verdict": {
"type": "string",
"enum": [
"pass",
"fail",
"could_not_verify"
]
},
"failed_before": {
"type": "integer",
"minimum": 0
},
"failed_now": {
"type": "integer",
"minimum": 0
},
"fixed": {
"type": "array",
"items": {
"type": "string"
}
},
"newly_failed": {
"type": "array",
"items": {
"type": "string"
}
},
"still_failing": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"previous_report",
"previous_as_of",
"previous_verdict",
"verdict",
"failed_before",
"failed_now",
"fixed",
"newly_failed",
"still_failing"
],
"additionalProperties": false
},
"report_url": {
"type": "string",
"format": "uri",
"description": "Present only when save=true and the content-free report was saved."
},
"supplier_seal": {
"type": "string",
"description": "Present for a newly saved PASS. Includes freshness, origin grade, true check-kind coverage, and adaptive footer links."
},
"delete_credential": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{43}$",
"description": "Returned once for an anonymous save. Send it in X-Licium-Report-Delete-Key to revoke the report."
},
"save_error": {
"type": "string",
"description": "Present when the verdict succeeded but the optional report could not be saved. The verdict remains usable and uploaded content was not stored."
},
"save_skipped": {
"type": "string",
"enum": [
"collection_off"
],
"description": "Present instead of report_url when an authenticated owner turned off collection in requester settings."
},
"save_skipped_message": {
"type": "string",
"description": "Human-readable explanation accompanying save_skipped."
}
},
"additionalProperties": false
}
},
"additionalProperties": false,
"$defs": {
"AcceptanceCriterion": {
"type": "object",
"required": [
"checkId",
"kind",
"label",
"params",
"blocking"
],
"properties": {
"checkId": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"kind": {
"type": "string",
"enum": [
"format",
"schema",
"count_range",
"marker_honesty",
"url_reachability",
"glossary_adherence",
"timestamp_coverage",
"assertion_substance",
"conflict_reporting",
"rubric_agreement",
"source_reverification",
"no_duplicate_rows",
"column_variety",
"column_completeness",
"column_format_consistency",
"date_freshness",
"no_future_dates",
"date_order",
"reference_overlap"
]
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 300
},
"params": {
"type": "object",
"additionalProperties": true,
"description": "Parameters by kind: no_duplicate_rows {}; column_variety, column_completeness, column_format_consistency, and no_future_dates { column }; date_freshness { column?, max_age_days? = 365 }; date_order { start_column, end_column }; reference_overlap { key_column, min_agreement? = 0.9, min_overlap? = 10 }. reference_rows are attached to the bounty. Text is trimmed and Unicode NFC-normalized. Finite numbers use canonical JSON text and match the same normalized text cell. Booleans stay distinct from strings. Null, missing fields, and empty strings are distinct."
},
"blocking": {
"type": "boolean",
"const": true
},
"evaluator": {
"type": "string",
"enum": [
"deterministic",
"llm",
"human"
],
"default": "deterministic"
},
"max_unresolved_pct": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Optional coverage floor. It is valid only on the same count_range criterion that supplies the positive declared item count."
}
},
"additionalProperties": false
},
"CheckLocator": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"row",
"column"
],
"properties": {
"kind": {
"type": "string",
"const": "cell"
},
"row": {
"type": "integer",
"minimum": 1
},
"column": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"row"
],
"properties": {
"kind": {
"type": "string",
"const": "row"
},
"row": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"column"
],
"properties": {
"kind": {
"type": "string",
"const": "column"
},
"column": {
"type": "string"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"line"
],
"properties": {
"kind": {
"type": "string",
"const": "line"
},
"line": {
"type": "integer",
"minimum": 1
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"start",
"end",
"line",
"sentence"
],
"properties": {
"kind": {
"type": "string",
"const": "text_range"
},
"start": {
"type": "integer",
"minimum": 0
},
"end": {
"type": "integer",
"minimum": 0
},
"line": {
"type": "integer",
"minimum": 1
},
"sentence": {
"type": "integer",
"minimum": 0
}
},
"additionalProperties": false
},
{
"type": "object",
"description": "A timestamp range emitted only for text transcripts.",
"required": [
"kind",
"start_seconds",
"end_seconds"
],
"properties": {
"kind": {
"type": "string",
"const": "time_range"
},
"start_seconds": {
"type": "number",
"minimum": 0
},
"end_seconds": {
"anyOf": [
{
"type": "number",
"minimum": 0
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
]
},
"CheckObservation": {
"type": "object",
"required": [
"id",
"kind",
"severity",
"title",
"detail",
"evidence",
"suggested_criterion"
],
"properties": {
"id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"duplicate_rows",
"uniform_column",
"sparse_column",
"mixed_formats",
"stale_dates",
"future_dates",
"contradictory_dates",
"unreachable_sources",
"unsupported_sources",
"llm_note"
],
"description": "duplicate_rows … unsupported_sources are computed deterministically. llm_note is an advisory note written by a language model from a small sample of rows and per-column statistics; it is present only when the operator enables that pass, follows the same text rules (headers, counts, row numbers, aggregate dates only), and never changes the verdict."
},
"severity": {
"type": "string",
"enum": [
"info",
"warn"
]
},
"title": {
"type": "string"
},
"detail": {
"type": "string"
},
"evidence": {
"type": "object",
"required": [
"rows",
"cells",
"urls",
"counts",
"checked_at"
],
"properties": {
"rows": {
"type": "array",
"maxItems": 10,
"items": {
"type": "integer",
"minimum": 1
},
"description": "Positions. For tabular deliveries, 1-based data-row numbers (header excluded); for non-tabular deliveries, 1-based line numbers."
},
"cells": {
"type": "array",
"maxItems": 10,
"description": "Tabular deliveries only. column is the header text or \"column N\"; value is truncated to 120 characters. Not stored in saved reports.",
"items": {
"type": "object",
"required": [
"row",
"column",
"value"
],
"properties": {
"row": {
"type": "integer",
"minimum": 1
},
"column": {
"type": "string"
},
"value": {
"type": "string",
"maxLength": 120
}
},
"additionalProperties": false
}
},
"urls": {
"type": "array",
"maxItems": 5,
"items": {
"type": "string",
"format": "uri"
},
"description": "Sampled source URLs for unreachable_sources and unsupported_sources. Not stored in saved reports."
},
"counts": {
"type": "object",
"additionalProperties": {
"type": "integer"
}
},
"checked_at": {
"type": "string",
"format": "date-time"
}
},
"additionalProperties": false
},
"suggested_criterion": {
"type": "string"
}
},
"additionalProperties": false
},
"CriterionResult": {
"type": "object",
"required": [
"check_id",
"kind",
"label",
"passed",
"blocking",
"item_notes"
],
"properties": {
"check_id": {
"type": "string"
},
"kind": {
"type": "string",
"enum": [
"format",
"schema",
"count_range",
"marker_honesty",
"url_reachability",
"glossary_adherence",
"timestamp_coverage",
"assertion_substance",
"conflict_reporting",
"rubric_agreement",
"source_reverification",
"no_duplicate_rows",
"column_variety",
"column_completeness",
"column_format_consistency",
"date_freshness",
"no_future_dates",
"date_order",
"reference_overlap"
]
},
"label": {
"type": "string"
},
"passed": {
"type": "boolean"
},
"blocking": {
"type": "boolean"
},
"item_notes": {
"type": "array",
"items": {
"type": "object",
"required": [
"item",
"passed",
"note",
"locators"
],
"properties": {
"item": {
"type": "string"
},
"passed": {
"type": "boolean"
},
"note": {
"type": "string"
},
"locators": {
"type": "array",
"maxItems": 20,
"items": {
"$ref": "#/$defs/CheckLocator"
}
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
}
}
}
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.
Call it yourself
curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/licium-ai-received-work-check-envelope"
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. By signing up you are subscribing to the APIs.io and API Evangelist newsletters — you can unsubscribe from any issue. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.