Machine-native utility network: verified evidence services for autonomous agents.
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Build a proof-carrying graph of public company identity, SEC filings, website observations, regulatory mentions, and repository signals. Use when: the request needs entity-level evidence synthesized across sources. Do not use when: one URL is the subject (use siteborne_retrieve_verified_web_context), one document is the subject (use siteborne_extract_document_evidence_json), or an existing agent output needs evaluation (use siteborne_verify_agent_output). Parameters: authoritative identifiers (cik, lei, isin, cusip, figi) resolve entities more reliably than company_name, ticker or domain alone, and combining them reduces ambiguity; requested_field_groups narrows provider work; maximum_authorized_price only constrains payment and never widens scope. Behavior: open-world: a paid request queries public data providers over the network and persists governed payment, audit, job and Workflow state; an unpaid request returns payment_required; a repeated identical request with the same payment is replay-protected and is not charged twice. This service is currently production-disabled and rejects execution. Economics: exact price of $0.0312 USD per request; the payment challenge requires that amount and the charge settles at exactly that amount. Failure: input that fails schema validation is rejected before any payment challenge; provider or service unavailability returns a structured MCP error. Returns: a company evidence graph with provenance, completeness, verification, and PCC context—not a raw webpage or document extraction.
Primary website hostname only, without a URL path; links first-party web evidence to the company identity.
One-to-five uppercase exchange ticker symbols; narrows public-company resolution but is not globally unique without other signals.
Up to twenty public supplemental evidence URLs supplied by the buyer; these are additional sources, not replacements for entity resolution.
Known authoritative entity identifiers; supplying precise identifiers reduces ambiguous name, ticker, or domain matching.
Legal or commonly used company name; supplies an entity-resolution signal when authoritative identifiers are unavailable.
Maximum acceptable source age in seconds, from 0 through 2,592,000; lower values demand fresher evidence.
Up to five two-letter uppercase jurisdiction codes used to focus regulatory context; hints do not assert incorporation.
Required completeness ratio from 0 through 1; results below this threshold fail the requested acceptance condition.
Unique evidence categories to collect; omitted values use the schema default, while a smaller list limits provider work and result scope.
Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never expands provider scope.
Required PCC verification ratio from 0 through 1; raising it makes result acceptance stricter.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Build a proof-carrying graph of public company identity, SEC filings, website observations, regulatory mentions, and repository signals. Use when: the request needs entity-level evidence synthesized across sources. Do not use when: one URL is the subject (use siteborne_retrieve_verified_web_context), one document is the subject (use siteborne_extract_document_evidence_json), or an existing agent output needs evaluation (use siteborne_verify_agent_output). Parameters: authoritative identifiers (cik, lei, isin, cusip, figi) resolve entities more reliably than company_name, ticker or domain alone, and combining them reduces ambiguity; requested_field_groups narrows provider work; maximum_authorized_price only constrains payment and never widens scope. Behavior: open-world: a paid request queries public data providers over the network and persists governed payment, audit, job and Workflow state; an unpaid request returns payment_required; a repeated identical request with the same payment is replay-protected and is not charged twice. This service is currently production-disabled and rejects execution. Economics: exact price of $0.0312 USD per request; the payment challenge requires that amount and the charge settles at exactly that amount. Failure: input that fails schema validation is rejected before any payment challenge; provider or service unavailability returns a structured MCP error. Returns: a company evidence graph with provenance, completeness, verification, and PCC context—not a raw webpage or document extraction.
| Argument | Type | Description |
|---|---|---|
| domain | string | Primary website hostname only, without a URL path; links first-party web evidence to the company identity. |
| ticker | string | One-to-five uppercase exchange ticker symbols; narrows public-company resolution but is not globally unique without other signals. |
| buyer_urls | array | Up to twenty public supplemental evidence URLs supplied by the buyer; these are additional sources, not replacements for entity resolution. |
| identifiers | object | Known authoritative entity identifiers; supplying precise identifiers reduces ambiguous name, ticker, or domain matching. |
| company_name | string | Legal or commonly used company name; supplies an entity-resolution signal when authoritative identifiers are unavailable. |
| freshness_seconds | integer | Maximum acceptable source age in seconds, from 0 through 2,592,000; lower values demand fresher evidence. |
| jurisdiction_hints | array | Up to five two-letter uppercase jurisdiction codes used to focus regulatory context; hints do not assert incorporation. |
| minimum_completeness | number | Required completeness ratio from 0 through 1; results below this threshold fail the requested acceptance condition. |
| requested_field_groups | array | Unique evidence categories to collect; omitted values use the schema default, while a smaller list limits provider work and result scope. |
| maximum_authorized_price | object | Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never expands provider scope. |
| minimum_verification_score | number | Required PCC verification ratio from 0 through 1; raising it makes result acceptance stricter. |
{
"$id": "https://siteborne.net/schemas/services/company-evidence-input.schema.json",
"type": "object",
"anyOf": [
{
"required": [
"company_name"
]
},
{
"required": [
"ticker"
]
},
{
"required": [
"domain"
]
},
{
"required": [
"identifiers"
]
}
],
"title": "Company Evidence Graph Input",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"examples": [
{
"domain": "acme.example.com",
"company_name": "Acme Corporation",
"freshness_seconds": 86400,
"requested_field_groups": [
"identity",
"sec_submissions",
"website_evidence"
],
"minimum_verification_score": 0.7
}
],
"required": [],
"properties": {
"domain": {
"type": "string",
"format": "hostname",
"maxLength": 253,
"description": "Primary website hostname only, without a URL path; links first-party web evidence to the company identity."
},
"ticker": {
"type": "string",
"pattern": "^[A-Z]{1,5}$",
"maxLength": 5,
"description": "One-to-five uppercase exchange ticker symbols; narrows public-company resolution but is not globally unique without other signals."
},
"buyer_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"maxItems": 20,
"description": "Up to twenty public supplemental evidence URLs supplied by the buyer; these are additional sources, not replacements for entity resolution."
},
"identifiers": {
"type": "object",
"properties": {
"cik": {
"type": "string",
"pattern": "^[0-9]{10}$",
"description": "Exactly ten decimal digits identifying the company in SEC EDGAR."
},
"lei": {
"type": "string",
"pattern": "^[A-Z0-9]{20}$",
"description": "Exactly twenty uppercase alphanumeric characters for the Legal Entity Identifier."
},
"figi": {
"type": "string",
"pattern": "^BBG[0-9A-Z]{9}$",
"description": "Twelve-character OpenFIGI identifier beginning with BBG."
},
"isin": {
"type": "string",
"pattern": "^[A-Z]{2}[A-Z0-9]{9}[0-9]$",
"description": "Twelve-character International Securities Identification Number."
},
"cusip": {
"type": "string",
"pattern": "^[A-Z0-9]{9}$",
"description": "Nine-character CUSIP security identifier."
},
"exchange": {
"type": "string",
"maxLength": 16,
"description": "Primary listing exchange name or code, up to sixteen characters; disambiguates reused ticker symbols."
},
"ticker_symbol": {
"type": "string",
"pattern": "^[A-Z]{1,5}$",
"description": "One-to-five uppercase characters for the primary listed ticker when it differs from ticker."
}
},
"description": "Known authoritative entity identifiers; supplying precise identifiers reduces ambiguous name, ticker, or domain matching.",
"maxProperties": 10,
"additionalProperties": false
},
"company_name": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"description": "Legal or commonly used company name; supplies an entity-resolution signal when authoritative identifiers are unavailable."
},
"freshness_seconds": {
"type": "integer",
"default": 86400,
"maximum": 2592000,
"minimum": 0,
"description": "Maximum acceptable source age in seconds, from 0 through 2,592,000; lower values demand fresher evidence."
},
"jurisdiction_hints": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"maxLength": 2
},
"maxItems": 5,
"description": "Up to five two-letter uppercase jurisdiction codes used to focus regulatory context; hints do not assert incorporation."
},
"minimum_completeness": {
"type": "number",
"default": 0.5,
"maximum": 1,
"minimum": 0,
"description": "Required completeness ratio from 0 through 1; results below this threshold fail the requested acceptance condition."
},
"requested_field_groups": {
"type": "array",
"items": {
"enum": [
"identity",
"sec_submissions",
"xbrl_facts",
"recent_filings",
"website_evidence",
"regulatory_mentions",
"public_repository_signals"
],
"type": "string"
},
"default": [
"identity",
"sec_submissions",
"recent_filings",
"website_evidence"
],
"maxItems": 7,
"description": "Unique evidence categories to collect; omitted values use the schema default, while a smaller list limits provider work and result scope.",
"uniqueItems": true
},
"maximum_authorized_price": {
"type": "object",
"title": "Decimal Money",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"asset": "USDC",
"amount": "0.19",
"network": "base-mainnet",
"currency": "USD"
}
],
"required": [
"amount",
"currency"
],
"properties": {
"asset": {
"type": "string",
"pattern": "^[A-Z0-9]{3,10}$",
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."
},
"amount": {
"type": "string",
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."
},
"network": {
"type": "string",
"pattern": "^[a-z0-9-]+$",
"maxLength": 64,
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."
},
"currency": {
"enum": [
"USD"
],
"type": "string",
"default": "USD",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code."
},
"precision": {
"type": "integer",
"default": 6,
"maximum": 18,
"minimum": 0,
"description": "Maximum decimal places supported by the asset/network. Metadata only."
}
},
"description": "Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never expands provider scope.",
"additionalProperties": false
},
"minimum_verification_score": {
"type": "number",
"default": 0.7,
"maximum": 1,
"minimum": 0,
"description": "Required PCC verification ratio from 0 through 1; raising it makes result acceptance stricter."
}
},
"description": "Input schema for company_evidence_graph.v1 service. At least one identity signal is required.",
"additionalProperties": false
}Build a proof-carrying graph of public company identity, SEC filings, website observations, regulatory mentions, and repository signals. Use when: the request needs entity-level evidence synthesized across sources. Do not use when: one URL is the subject (use siteborne_retrieve_verified_web_context), one document is the subject (use siteborne_extract_document_evidence_json), or an existing agent output needs evaluation (use siteborne_verify_agent_output). Parameters: authoritative identifiers (cik, lei, isin, cusip, figi) resolve entities more reliably than company_name, ticker or domain alone, and combining them reduces ambiguity; requested_field_groups narrows provider work; maximum_authorized_price only constrains payment and never widens scope. Behavior: open-world: a paid request queries public data providers over the network and persists governed payment, audit, job and Workflow state; an unpaid request returns payment_required; a repeated identical request with the same payment is replay-protected and is not charged twice. This service is currently production-disabled and rejects execution. Economics: exact price of $0.0312 USD per request; the payment challenge requires that amount and the charge settles at exactly that amount. Failure: input that fails schema validation is rejected before any payment challenge; provider or service unavailability returns a structured MCP error. Returns: a company evidence graph with provenance, completeness, verification, and PCC context—not a raw webpage or document extraction.
| Argument | Type | Description |
|---|---|---|
| domain | string | Primary website hostname only, without a URL path; links first-party web evidence to the company identity. |
| ticker | string | One-to-five uppercase exchange ticker symbols; narrows public-company resolution but is not globally unique without other signals. |
| buyer_urls | array |
Extract and verify structured evidence from exactly one authorized artifact, prior SITEBORNE upload, or public document URL. Use when: the source of truth is a PDF or supported image and the desired result is evidence JSON. Do not use when: a webpage alone is sufficient (use siteborne_retrieve_verified_web_context), company-wide public evidence is needed (use siteborne_build_company_evidence_graph), or an existing agent response needs evaluation (use siteborne_verify_agent_output). Parameters: provide exactly one reference mode: artifact_reference (an authorized stored artifact), upload_reference (a prior SITEBORNE upload handle, not document bytes) or document_url (a public URL, no credentials). ocr_permission must be true before image-based content is read by OCR, and OCR pages bill at the OCR tier; extraction_request.extract_tables and table_extraction_request request table extraction, and pages with tables bill at the table tier; declared_page_count and page_range are bounded by the page limit below; maximum_authorized_price only constrains payment. Behavior: open-world: a paid request may read governed artifact storage or fetch a public document URL, calls the document provider, and persists payment, audit, job and Workflow state; an unpaid request returns payment_required; a repeated identical request with the same payment is replay-protected and is not charged twice. This service is currently production-disabled and rejects execution. Economics: upto pricing: the payment challenge authorizes a maximum of $0.19 USD per job; the actual charge is measured per processed page (native-text $0.0098, OCR $0.0156, table $0.0238 per page, the highest applicable tier per page) and never exceeds the authorization. The authorization is a ceiling, not the charge. Documents are limited to 10 pages per job. Failure: schema-invalid input is rejected before any payment challenge; a document over the page limit, an unreadable or encrypted document, or an unavailable provider returns a structured MCP error. Returns: extracted document evidence, integrity/provenance findings, and PCC verification—not an uploaded file.
| Argument | Type | Description |
|---|---|---|
| page_range | object |
Extract and verify structured evidence from exactly one authorized artifact, prior SITEBORNE upload, or public document URL. Use when: the source of truth is a PDF or supported image and the desired result is evidence JSON. Do not use when: a webpage alone is sufficient (use siteborne_retrieve_verified_web_context), company-wide public evidence is needed (use siteborne_build_company_evidence_graph), or an existing agent response needs evaluation (use siteborne_verify_agent_output). Parameters: provide exactly one reference mode: artifact_reference (an authorized stored artifact), upload_reference (a prior SITEBORNE upload handle, not document bytes) or document_url (a public URL, no credentials). ocr_permission must be true before image-based content is read by OCR, and OCR pages bill at the OCR tier; extraction_request.extract_tables and table_extraction_request request table extraction, and pages with tables bill at the table tier; declared_page_count and page_range are bounded by the page limit below; maximum_authorized_price only constrains payment. Behavior: open-world: a paid request may read governed artifact storage or fetch a public document URL, calls the document provider, and persists payment, audit, job and Workflow state; an unpaid request returns payment_required; a repeated identical request with the same payment is replay-protected and is not charged twice. This service is currently production-disabled and rejects execution. Economics: upto pricing: the payment challenge authorizes a maximum of $0.19 USD per job; the actual charge is measured per processed page (native-text $0.0098, OCR $0.0156, table $0.0238 per page, the highest applicable tier per page) and never exceeds the authorization. The authorization is a ceiling, not the charge. Documents are limited to 10 pages per job. Failure: schema-invalid input is rejected before any payment challenge; a document over the page limit, an unreadable or encrypted document, or an unavailable provider returns a structured MCP error. Returns: extracted document evidence, integrity/provenance findings, and PCC verification—not an uploaded file.
| Argument | Type | Description |
|---|---|---|
| page_range | object |
Build a canonical x402 payment quote for one SITEBORNE service and exact request input. Use when: an agent needs the governed price, payee, network, asset, resource, expiry, and payment requirement before deciding whether to invoke a paid service. Do not use when: evidence work is required now (use the matching siteborne_build_company_evidence_graph, siteborne_retrieve_verified_web_context, siteborne_extract_document_evidence_json, or siteborne_verify_agent_output tool), or only availability is needed (use siteborne_get_service_health). Parameters: scheme must be the one scheme the service is offered under (company_evidence_graph.v2 exact, web_context_verified.v2 exact, document_evidence_json.v2 upto, verify_agent_output.v2 exact, company_evidence_graph.v3 exact, web_context_verified.v3 exact, document_evidence_json.v3 upto, verify_agent_output.v3 exact); any other scheme is rejected with scheme_not_offered. input is hashed, so the quote binds only that exact request. Behavior: quote-only and read-only; it hashes the proposed input, and does not execute the underlying paid service, verify payment, call a provider, create a Workflow, or settle. Economics: free of charge. The returned amount is the exact price, or for upto an authorized maximum whose actual_amount is null because the real charge is measured at settlement and never exceeds it. Failure: a mode that has a governed price but is unavailable returns retrieval_mode_unavailable or verification_mode_unavailable and no quote; a quote expires at expires_at. Returns: an expiring input-bound quote with its x402 payment requirement and the canonical economics block.
| Argument | Type | Description |
|---|---|---|
| input* | any | Complete proposed input for the selected service; its canonical hash binds the quote and later payment requirement to this exact request content. |
| scheme* | string |
Report MCP server readiness and production-enable status for each SITEBORNE service. Use when: an agent must check protocol availability, tool count, or whether a service is currently production-enabled before selecting a paid tool. Do not use when: a quote is needed (use siteborne_get_quote) or company, web, document, or agent-output evidence work is required (use the corresponding SITEBORNE service tool). Behavior: read-only and credential-independent; it does not perform paid evidence work, create quotes, verify payment, call providers, write service state, create Workflows, or settle. Economics: free of charge; it never issues a payment challenge. Failure: it depends on no provider, so it does not fail because a provider is unavailable. Returns: the server and protocol versions plus truthful local, production, and external-publication status for all four evidence services.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {},
"additionalProperties": false
}Retrieve and verify evidence from one public web URL using direct HTTP retrieval. Use when: the request is specifically about the content and provenance of a URL. Do not use when: evidence must be synthesized for a company (use siteborne_build_company_evidence_graph), extracted from an authorized document (use siteborne_extract_document_evidence_json), checked against an existing output contract (use siteborne_verify_agent_output), or the page requires JavaScript rendering (rendered retrieval is not available). Parameters: retrieval_mode must be direct; rendered is defined but unavailable and is rejected before any payment challenge, never substituted with direct retrieval. output_mode structured needs buyer_schema and field_selectors to be meaningful; redirect_policy and max_redirects bound redirect following; max_content_size bounds returned bytes; maximum_authorized_price only constrains payment and never changes retrieval scope. Behavior: open-world: a paid request performs bounded outbound HTTP retrieval of the target URL through a safe-egress boundary (private and loopback destinations are refused) and persists governed payment, audit, job and Workflow state; an unpaid request returns payment_required; a repeated identical request with the same payment is replay-protected and is not charged twice. Retrieval admission follows the governed runtime rate policy; no fixed public per-origin rate is promised. This service is currently production-disabled and rejects execution. Economics: exact price of $0.008 USD per request in direct mode; the payment challenge requires that amount and the charge settles at exactly that amount. rendered mode has a governed price of $0.029 USD but is not available: it is rejected before any payment challenge and never substituted. Failure: schema-invalid input and unavailable modes are rejected before any payment challenge; target-site errors, timeouts and unavailable retrieval return a structured MCP error and are never answered with a substitute result. Returns: normalized, source-attributed web context with verification and PCC evidence.
| Argument | Type | Description |
|---|---|---|
| target_url* | string |
Retrieve and verify evidence from one public web URL using direct HTTP retrieval. Use when: the request is specifically about the content and provenance of a URL. Do not use when: evidence must be synthesized for a company (use siteborne_build_company_evidence_graph), extracted from an authorized document (use siteborne_extract_document_evidence_json), checked against an existing output contract (use siteborne_verify_agent_output), or the page requires JavaScript rendering (rendered retrieval is not available). Parameters: retrieval_mode must be direct; rendered is defined but unavailable and is rejected before any payment challenge, never substituted with direct retrieval. output_mode structured needs buyer_schema and field_selectors to be meaningful; redirect_policy and max_redirects bound redirect following; max_content_size bounds returned bytes; maximum_authorized_price only constrains payment and never changes retrieval scope. Behavior: open-world: a paid request performs bounded outbound HTTP retrieval of the target URL through a safe-egress boundary (private and loopback destinations are refused) and persists governed payment, audit, job and Workflow state; an unpaid request returns payment_required; a repeated identical request with the same payment is replay-protected and is not charged twice. Retrieval admission follows the governed runtime rate policy; no fixed public per-origin rate is promised. This service is currently production-disabled and rejects execution. Economics: exact price of $0.008 USD per request in direct mode; the payment challenge requires that amount and the charge settles at exactly that amount. rendered mode has a governed price of $0.029 USD but is not available: it is rejected before any payment challenge and never substituted. Failure: schema-invalid input and unavailable modes are rejected before any payment challenge; target-site errors, timeouts and unavailable retrieval return a structured MCP error and are never answered with a substitute result. Returns: normalized, source-attributed web context with verification and PCC evidence.
| Argument | Type | Description |
|---|---|---|
| target_url* | string |
Evaluate a supplied agent output against explicit claims, deterministic requirements, a required JSON Schema, and optional evidence. Use when: the caller already has an output and needs a governed verification verdict. Do not use when: evidence must first be gathered from a company (use siteborne_build_company_evidence_graph), URL (use siteborne_retrieve_verified_web_context), or document (use siteborne_extract_document_evidence_json), or independent reproduction of the output is required (not available). Parameters: verification_mode must be standard; independent_reproduction is defined but unavailable and is rejected before any payment challenge, never downgraded to standard. required_schema must fit SITEBORNE JSON Schema Profile 1 or the request is rejected before payment; minimum_score sets the acceptance threshold; maximum_authorized_price only constrains payment and never relaxes verification policy. Behavior: closed-world: standard mode evaluates only the supplied claims, requirements, output and evidence with no outbound retrieval, and persists governed payment, audit, job and Workflow state; an unpaid request returns payment_required; a repeated identical request with the same payment is replay-protected and is not charged twice. The verification policy and verdict rules do not depend on price or maximum_authorized_price. This service is currently production-disabled and rejects execution. Economics: exact price of $0.017 USD per request in standard mode; the payment challenge requires that amount and the charge settles at exactly that amount. independent_reproduction mode has a governed price of $0.049 USD but is not available: it is rejected before any payment challenge and never substituted. Failure: an unsupported or oversized required_schema, schema-invalid input and unavailable modes are rejected before any payment challenge; a failed verification is a normal fail or conditional verdict, not an error. Returns: claim-level and deterministic-check results, an overall verification verdict, and PCC evidence—not newly gathered source content.
| Argument | Type | Description |
|---|---|---|
| minimum_score | number | Minimum overall verification score from 0 through 1; raising it makes the final acceptance verdict stricter. |
Evaluate a supplied agent output against explicit claims, deterministic requirements, a required JSON Schema, and optional evidence. Use when: the caller already has an output and needs a governed verification verdict. Do not use when: evidence must first be gathered from a company (use siteborne_build_company_evidence_graph), URL (use siteborne_retrieve_verified_web_context), or document (use siteborne_extract_document_evidence_json), or independent reproduction of the output is required (not available). Parameters: verification_mode must be standard; independent_reproduction is defined but unavailable and is rejected before any payment challenge, never downgraded to standard. required_schema must fit SITEBORNE JSON Schema Profile 1 or the request is rejected before payment; minimum_score sets the acceptance threshold; maximum_authorized_price only constrains payment and never relaxes verification policy. Behavior: closed-world: standard mode evaluates only the supplied claims, requirements, output and evidence with no outbound retrieval, and persists governed payment, audit, job and Workflow state; an unpaid request returns payment_required; a repeated identical request with the same payment is replay-protected and is not charged twice. The verification policy and verdict rules do not depend on price or maximum_authorized_price. This service is currently production-disabled and rejects execution. Economics: exact price of $0.017 USD per request in standard mode; the payment challenge requires that amount and the charge settles at exactly that amount. independent_reproduction mode has a governed price of $0.049 USD but is not available: it is rejected before any payment challenge and never substituted. Failure: an unsupported or oversized required_schema, schema-invalid input and unavailable modes are rejected before any payment challenge; a failed verification is a normal fail or conditional verdict, not an error. Returns: claim-level and deterministic-check results, an overall verification verdict, and PCC evidence—not newly gathered source content.
| Argument | Type | Description |
|---|---|---|
| minimum_score | number | Minimum overall verification score from 0 through 1; raising it makes the final acceptance verdict stricter. |
| Up to twenty public supplemental evidence URLs supplied by the buyer; these are additional sources, not replacements for entity resolution. |
| identifiers | object | Known authoritative entity identifiers; supplying precise identifiers reduces ambiguous name, ticker, or domain matching. |
| company_name | string | Legal or commonly used company name; supplies an entity-resolution signal when authoritative identifiers are unavailable. |
| freshness_seconds | integer | Maximum acceptable source age in seconds, from 0 through 2,592,000; lower values demand fresher evidence. |
| jurisdiction_hints | array | Up to five two-letter uppercase jurisdiction codes used to focus regulatory context; hints do not assert incorporation. |
| minimum_completeness | number | Required completeness ratio from 0 through 1; results below this threshold fail the requested acceptance condition. |
| requested_field_groups | array | Unique evidence categories to collect; omitted values use the schema default, while a smaller list limits provider work and result scope. |
| maximum_authorized_price | object | Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never expands provider scope. |
| minimum_verification_score | number | Required PCC verification ratio from 0 through 1; raising it makes result acceptance stricter. |
{
"$id": "https://siteborne.net/schemas/services/company-evidence-input.schema.json",
"type": "object",
"anyOf": [
{
"required": [
"company_name"
]
},
{
"required": [
"ticker"
]
},
{
"required": [
"domain"
]
},
{
"required": [
"identifiers"
]
}
],
"title": "Company Evidence Graph Input",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"examples": [
{
"domain": "acme.example.com",
"company_name": "Acme Corporation",
"freshness_seconds": 86400,
"requested_field_groups": [
"identity",
"sec_submissions",
"website_evidence"
],
"minimum_verification_score": 0.7
}
],
"required": [],
"properties": {
"domain": {
"type": "string",
"format": "hostname",
"maxLength": 253,
"description": "Primary website hostname only, without a URL path; links first-party web evidence to the company identity."
},
"ticker": {
"type": "string",
"pattern": "^[A-Z]{1,5}$",
"maxLength": 5,
"description": "One-to-five uppercase exchange ticker symbols; narrows public-company resolution but is not globally unique without other signals."
},
"buyer_urls": {
"type": "array",
"items": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"maxItems": 20,
"description": "Up to twenty public supplemental evidence URLs supplied by the buyer; these are additional sources, not replacements for entity resolution."
},
"identifiers": {
"type": "object",
"properties": {
"cik": {
"type": "string",
"pattern": "^[0-9]{10}$",
"description": "Exactly ten decimal digits identifying the company in SEC EDGAR."
},
"lei": {
"type": "string",
"pattern": "^[A-Z0-9]{20}$",
"description": "Exactly twenty uppercase alphanumeric characters for the Legal Entity Identifier."
},
"figi": {
"type": "string",
"pattern": "^BBG[0-9A-Z]{9}$",
"description": "Twelve-character OpenFIGI identifier beginning with BBG."
},
"isin": {
"type": "string",
"pattern": "^[A-Z]{2}[A-Z0-9]{9}[0-9]$",
"description": "Twelve-character International Securities Identification Number."
},
"cusip": {
"type": "string",
"pattern": "^[A-Z0-9]{9}$",
"description": "Nine-character CUSIP security identifier."
},
"exchange": {
"type": "string",
"maxLength": 16,
"description": "Primary listing exchange name or code, up to sixteen characters; disambiguates reused ticker symbols."
},
"ticker_symbol": {
"type": "string",
"pattern": "^[A-Z]{1,5}$",
"description": "One-to-five uppercase characters for the primary listed ticker when it differs from ticker."
}
},
"description": "Known authoritative entity identifiers; supplying precise identifiers reduces ambiguous name, ticker, or domain matching.",
"maxProperties": 10,
"additionalProperties": false
},
"company_name": {
"type": "string",
"maxLength": 256,
"minLength": 1,
"description": "Legal or commonly used company name; supplies an entity-resolution signal when authoritative identifiers are unavailable."
},
"freshness_seconds": {
"type": "integer",
"default": 86400,
"maximum": 2592000,
"minimum": 0,
"description": "Maximum acceptable source age in seconds, from 0 through 2,592,000; lower values demand fresher evidence."
},
"jurisdiction_hints": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"maxLength": 2
},
"maxItems": 5,
"description": "Up to five two-letter uppercase jurisdiction codes used to focus regulatory context; hints do not assert incorporation."
},
"minimum_completeness": {
"type": "number",
"default": 0.5,
"maximum": 1,
"minimum": 0,
"description": "Required completeness ratio from 0 through 1; results below this threshold fail the requested acceptance condition."
},
"requested_field_groups": {
"type": "array",
"items": {
"enum": [
"identity",
"sec_submissions",
"xbrl_facts",
"recent_filings",
"website_evidence",
"regulatory_mentions",
"public_repository_signals"
],
"type": "string"
},
"default": [
"identity",
"sec_submissions",
"recent_filings",
"website_evidence"
],
"maxItems": 7,
"description": "Unique evidence categories to collect; omitted values use the schema default, while a smaller list limits provider work and result scope.",
"uniqueItems": true
},
"maximum_authorized_price": {
"type": "object",
"title": "Decimal Money",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"asset": "USDC",
"amount": "0.19",
"network": "base-mainnet",
"currency": "USD"
}
],
"required": [
"amount",
"currency"
],
"properties": {
"asset": {
"type": "string",
"pattern": "^[A-Z0-9]{3,10}$",
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."
},
"amount": {
"type": "string",
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."
},
"network": {
"type": "string",
"pattern": "^[a-z0-9-]+$",
"maxLength": 64,
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."
},
"currency": {
"enum": [
"USD"
],
"type": "string",
"default": "USD",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code."
},
"precision": {
"type": "integer",
"default": 6,
"maximum": 18,
"minimum": 0,
"description": "Maximum decimal places supported by the asset/network. Metadata only."
}
},
"description": "Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never expands provider scope.",
"additionalProperties": false
},
"minimum_verification_score": {
"type": "number",
"default": 0.7,
"maximum": 1,
"minimum": 0,
"description": "Required PCC verification ratio from 0 through 1; raising it makes result acceptance stricter."
}
},
"description": "Input schema for company_evidence_graph.v1 service. At least one identity signal is required.",
"additionalProperties": false
}| Optional one-indexed inclusive page range to process; both bounds are limited to pages 1 through 10. |
| document_url | string | Public document URL for reference mode 3; use exactly one reference mode and never put credentials in this URL. |
| language_hints | array | Up to five BCP 47 language hints used by OCR and extraction; hints do not translate the document. |
| ocr_permission | boolean | Explicit permission to use OCR for image-based content; false prevents OCR even when text is not embedded. |
| upload_reference | object | Previously issued SITEBORNE upload handle and declared file metadata for reference mode 2; it does not upload document bytes. |
| artifact_reference | object | Authorized stored-artifact descriptor for reference mode 1; use exactly one of artifact_reference, upload_reference, or document_url. |
| extraction_request | object | Selects text, table, key-value, and buyer-schema extraction outputs; omitted switches retain their documented defaults. |
| declared_page_count | integer | Optional declared page count from 1 through 10; enables early scope validation but does not override the observed document. |
| retention_preference | string | Requested retention class—none, temporary, or permanent—subject to server policy; it cannot override mandatory retention limits. |
| maximum_authorized_price | object | Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and not retention or extraction policy. |
| table_extraction_request | boolean | Explicit top-level request for table extraction; false leaves tables unrequested. |
| minimum_verification_score | number | Required PCC verification ratio from 0 through 1; raising it makes extracted-evidence acceptance stricter. |
{
"$id": "https://siteborne.net/schemas/services/document-evidence-input.schema.json",
"type": "object",
"oneOf": [
{
"required": [
"artifact_reference"
]
},
{
"required": [
"upload_reference"
]
},
{
"required": [
"document_url"
]
}
],
"title": "Document Evidence JSON Input",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"examples": [
{
"ocr_permission": true,
"artifact_reference": {
"media_type": "application/pdf",
"page_count": 5,
"size_bytes": 2048576,
"artifact_id": "doc/abc123/contract.pdf",
"content_hash": "sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"authorization": "buyer_authorized"
},
"extraction_request": {
"extract_tables": true,
"extract_key_values": true
},
"maximum_authorized_price": {
"amount": "0.19",
"currency": "USD"
}
}
],
"properties": {
"page_range": {
"type": "object",
"properties": {
"end": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Last one-indexed page to process, inclusive and not before start."
},
"start": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "First one-indexed page to process, inclusive."
}
},
"description": "Optional one-indexed inclusive page range to process; both bounds are limited to pages 1 through 10.",
"additionalProperties": false
},
"document_url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Public document URL for reference mode 3; use exactly one reference mode and never put credentials in this URL."
},
"language_hints": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z]{2,3}(-[A-Z]{2})?$"
},
"maxItems": 5,
"description": "Up to five BCP 47 language hints used by OCR and extraction; hints do not translate the document."
},
"ocr_permission": {
"type": "boolean",
"default": false,
"description": "Explicit permission to use OCR for image-based content; false prevents OCR even when text is not embedded."
},
"upload_reference": {
"type": "object",
"required": [
"upload_id",
"media_type",
"size_bytes"
],
"properties": {
"upload_id": {
"type": "string",
"maxLength": 512,
"description": "Opaque SITEBORNE upload identifier, up to 512 characters, that selects the already admitted artifact."
},
"media_type": {
"enum": [
"application/pdf",
"image/png",
"image/jpeg"
],
"type": "string",
"description": "Declared parser media type: PDF, PNG, or JPEG; it must match the stored artifact."
},
"size_bytes": {
"type": "integer",
"maximum": 10485760,
"minimum": 1,
"description": "Declared artifact size in bytes, from 1 through 10,485,760; it is checked against stored metadata."
},
"content_hash": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$",
"description": "Optional lowercase SHA-256 integrity identifier in sha256:<64 hex> form; when supplied it must match the artifact."
}
},
"description": "Previously issued SITEBORNE upload handle and declared file metadata for reference mode 2; it does not upload document bytes.",
"additionalProperties": false
},
"artifact_reference": {
"type": "object",
"title": "Authorized Artifact Reference",
"examples": [
{
"media_type": "application/pdf",
"page_count": 5,
"size_bytes": 2048576,
"artifact_id": "doc/abc123/evidence.pdf",
"content_hash": "sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"authorization": "buyer_authorized"
}
],
"required": [
"artifact_id",
"media_type",
"size_bytes"
],
"properties": {
"media_type": {
"enum": [
"application/pdf",
"image/png",
"image/jpeg"
],
"type": "string",
"description": "Declared MIME type of the artifact."
},
"page_count": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Declared page count when known."
},
"size_bytes": {
"type": "integer",
"maximum": 10485760,
"minimum": 1,
"description": "Declared size in bytes."
},
"artifact_id": {
"type": "string",
"maxLength": 512,
"description": "Unique artifact identifier (e.g., R2 object key, artifact registry ID)."
},
"access_token": {
"type": "string",
"maxLength": 2048,
"description": "Short-lived access token for private artifacts. Must not be logged."
},
"content_hash": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$",
"description": "SHA-256 content hash for integrity verification."
},
"authorization": {
"enum": [
"public",
"buyer_authorized"
],
"type": "string",
"description": "Authorization classification."
}
},
"description": "Authorized stored-artifact descriptor for reference mode 1; use exactly one of artifact_reference, upload_reference, or document_url.",
"additionalProperties": false
},
"extraction_request": {
"type": "object",
"properties": {
"buyer_schema": {
"type": "object",
"maxDepth": 5,
"description": "Optional JSON Schema, bounded to fifty properties and depth five, used to validate buyer-shaped extracted data.",
"maxProperties": 50,
"additionalProperties": true
},
"extract_text": {
"type": "boolean",
"default": true,
"description": "Whether normalized text extraction is requested; defaults to true."
},
"extract_tables": {
"type": "boolean",
"default": false,
"description": "Whether bounded table extraction is requested; defaults to false and may increase processing work."
},
"extract_key_values": {
"type": "boolean",
"default": false,
"description": "Whether key-value extraction is requested; defaults to false."
}
},
"description": "Selects text, table, key-value, and buyer-schema extraction outputs; omitted switches retain their documented defaults.",
"additionalProperties": false
},
"declared_page_count": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Optional declared page count from 1 through 10; enables early scope validation but does not override the observed document."
},
"retention_preference": {
"enum": [
"none",
"temporary",
"permanent"
],
"type": "string",
"default": "temporary",
"description": "Requested retention class—none, temporary, or permanent—subject to server policy; it cannot override mandatory retention limits."
},
"maximum_authorized_price": {
"type": "object",
"title": "Decimal Money",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"asset": "USDC",
"amount": "0.19",
"network": "base-mainnet",
"currency": "USD"
}
],
"required": [
"amount",
"currency"
],
"properties": {
"asset": {
"type": "string",
"pattern": "^[A-Z0-9]{3,10}$",
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."
},
"amount": {
"type": "string",
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."
},
"network": {
"type": "string",
"pattern": "^[a-z0-9-]+$",
"maxLength": 64,
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."
},
"currency": {
"enum": [
"USD"
],
"type": "string",
"default": "USD",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code."
},
"precision": {
"type": "integer",
"default": 6,
"maximum": 18,
"minimum": 0,
"description": "Maximum decimal places supported by the asset/network. Metadata only."
}
},
"description": "Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and not retention or extraction policy.",
"additionalProperties": false
},
"table_extraction_request": {
"type": "boolean",
"default": false,
"description": "Explicit top-level request for table extraction; false leaves tables unrequested."
},
"minimum_verification_score": {
"type": "number",
"default": 0.7,
"maximum": 1,
"minimum": 0,
"description": "Required PCC verification ratio from 0 through 1; raising it makes extracted-evidence acceptance stricter."
}
},
"description": "Input schema for document_evidence_json.v1 service. Exactly one document reference mode required.",
"additionalProperties": false
}| Optional one-indexed inclusive page range to process; both bounds are limited to pages 1 through 10. |
| document_url | string | Public document URL for reference mode 3; use exactly one reference mode and never put credentials in this URL. |
| language_hints | array | Up to five BCP 47 language hints used by OCR and extraction; hints do not translate the document. |
| ocr_permission | boolean | Explicit permission to use OCR for image-based content; false prevents OCR even when text is not embedded. |
| upload_reference | object | Previously issued SITEBORNE upload handle and declared file metadata for reference mode 2; it does not upload document bytes. |
| artifact_reference | object | Authorized stored-artifact descriptor for reference mode 1; use exactly one of artifact_reference, upload_reference, or document_url. |
| extraction_request | object | Selects text, table, key-value, and buyer-schema extraction outputs; omitted switches retain their documented defaults. |
| declared_page_count | integer | Optional declared page count from 1 through 10; enables early scope validation but does not override the observed document. |
| retention_preference | string | Requested retention class—none, temporary, or permanent—subject to server policy; it cannot override mandatory retention limits. |
| maximum_authorized_price | object | Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and not retention or extraction policy. |
| table_extraction_request | boolean | Explicit top-level request for table extraction; false leaves tables unrequested. |
| minimum_verification_score | number | Required PCC verification ratio from 0 through 1; raising it makes extracted-evidence acceptance stricter. |
{
"$id": "https://siteborne.net/schemas/services/document-evidence-input.schema.json",
"type": "object",
"oneOf": [
{
"required": [
"artifact_reference"
]
},
{
"required": [
"upload_reference"
]
},
{
"required": [
"document_url"
]
}
],
"title": "Document Evidence JSON Input",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"examples": [
{
"ocr_permission": true,
"artifact_reference": {
"media_type": "application/pdf",
"page_count": 5,
"size_bytes": 2048576,
"artifact_id": "doc/abc123/contract.pdf",
"content_hash": "sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"authorization": "buyer_authorized"
},
"extraction_request": {
"extract_tables": true,
"extract_key_values": true
},
"maximum_authorized_price": {
"amount": "0.19",
"currency": "USD"
}
}
],
"properties": {
"page_range": {
"type": "object",
"properties": {
"end": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Last one-indexed page to process, inclusive and not before start."
},
"start": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "First one-indexed page to process, inclusive."
}
},
"description": "Optional one-indexed inclusive page range to process; both bounds are limited to pages 1 through 10.",
"additionalProperties": false
},
"document_url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Public document URL for reference mode 3; use exactly one reference mode and never put credentials in this URL."
},
"language_hints": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z]{2,3}(-[A-Z]{2})?$"
},
"maxItems": 5,
"description": "Up to five BCP 47 language hints used by OCR and extraction; hints do not translate the document."
},
"ocr_permission": {
"type": "boolean",
"default": false,
"description": "Explicit permission to use OCR for image-based content; false prevents OCR even when text is not embedded."
},
"upload_reference": {
"type": "object",
"required": [
"upload_id",
"media_type",
"size_bytes"
],
"properties": {
"upload_id": {
"type": "string",
"maxLength": 512,
"description": "Opaque SITEBORNE upload identifier, up to 512 characters, that selects the already admitted artifact."
},
"media_type": {
"enum": [
"application/pdf",
"image/png",
"image/jpeg"
],
"type": "string",
"description": "Declared parser media type: PDF, PNG, or JPEG; it must match the stored artifact."
},
"size_bytes": {
"type": "integer",
"maximum": 10485760,
"minimum": 1,
"description": "Declared artifact size in bytes, from 1 through 10,485,760; it is checked against stored metadata."
},
"content_hash": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$",
"description": "Optional lowercase SHA-256 integrity identifier in sha256:<64 hex> form; when supplied it must match the artifact."
}
},
"description": "Previously issued SITEBORNE upload handle and declared file metadata for reference mode 2; it does not upload document bytes.",
"additionalProperties": false
},
"artifact_reference": {
"type": "object",
"title": "Authorized Artifact Reference",
"examples": [
{
"media_type": "application/pdf",
"page_count": 5,
"size_bytes": 2048576,
"artifact_id": "doc/abc123/evidence.pdf",
"content_hash": "sha256:abcdef1234567890abcdef1234567890abcdef1234567890abcdef1234567890",
"authorization": "buyer_authorized"
}
],
"required": [
"artifact_id",
"media_type",
"size_bytes"
],
"properties": {
"media_type": {
"enum": [
"application/pdf",
"image/png",
"image/jpeg"
],
"type": "string",
"description": "Declared MIME type of the artifact."
},
"page_count": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Declared page count when known."
},
"size_bytes": {
"type": "integer",
"maximum": 10485760,
"minimum": 1,
"description": "Declared size in bytes."
},
"artifact_id": {
"type": "string",
"maxLength": 512,
"description": "Unique artifact identifier (e.g., R2 object key, artifact registry ID)."
},
"access_token": {
"type": "string",
"maxLength": 2048,
"description": "Short-lived access token for private artifacts. Must not be logged."
},
"content_hash": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$",
"description": "SHA-256 content hash for integrity verification."
},
"authorization": {
"enum": [
"public",
"buyer_authorized"
],
"type": "string",
"description": "Authorization classification."
}
},
"description": "Authorized stored-artifact descriptor for reference mode 1; use exactly one of artifact_reference, upload_reference, or document_url.",
"additionalProperties": false
},
"extraction_request": {
"type": "object",
"properties": {
"buyer_schema": {
"type": "object",
"maxDepth": 5,
"description": "Optional JSON Schema, bounded to fifty properties and depth five, used to validate buyer-shaped extracted data.",
"maxProperties": 50,
"additionalProperties": true
},
"extract_text": {
"type": "boolean",
"default": true,
"description": "Whether normalized text extraction is requested; defaults to true."
},
"extract_tables": {
"type": "boolean",
"default": false,
"description": "Whether bounded table extraction is requested; defaults to false and may increase processing work."
},
"extract_key_values": {
"type": "boolean",
"default": false,
"description": "Whether key-value extraction is requested; defaults to false."
}
},
"description": "Selects text, table, key-value, and buyer-schema extraction outputs; omitted switches retain their documented defaults.",
"additionalProperties": false
},
"declared_page_count": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Optional declared page count from 1 through 10; enables early scope validation but does not override the observed document."
},
"retention_preference": {
"enum": [
"none",
"temporary",
"permanent"
],
"type": "string",
"default": "temporary",
"description": "Requested retention class—none, temporary, or permanent—subject to server policy; it cannot override mandatory retention limits."
},
"maximum_authorized_price": {
"type": "object",
"title": "Decimal Money",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"asset": "USDC",
"amount": "0.19",
"network": "base-mainnet",
"currency": "USD"
}
],
"required": [
"amount",
"currency"
],
"properties": {
"asset": {
"type": "string",
"pattern": "^[A-Z0-9]{3,10}$",
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."
},
"amount": {
"type": "string",
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."
},
"network": {
"type": "string",
"pattern": "^[a-z0-9-]+$",
"maxLength": 64,
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."
},
"currency": {
"enum": [
"USD"
],
"type": "string",
"default": "USD",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code."
},
"precision": {
"type": "integer",
"default": 6,
"maximum": 18,
"minimum": 0,
"description": "Maximum decimal places supported by the asset/network. Metadata only."
}
},
"description": "Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and not retention or extraction policy.",
"additionalProperties": false
},
"table_extraction_request": {
"type": "boolean",
"default": false,
"description": "Explicit top-level request for table extraction; false leaves tables unrequested."
},
"minimum_verification_score": {
"type": "number",
"default": 0.7,
"maximum": 1,
"minimum": 0,
"description": "Required PCC verification ratio from 0 through 1; raising it makes extracted-evidence acceptance stricter."
}
},
"description": "Input schema for document_evidence_json.v1 service. Exactly one document reference mode required.",
"additionalProperties": false
}| Pricing mode: exact fixes the required amount, while upto authorizes a maximum whose eventual charge cannot exceed the returned amount. |
| service_id* | string | Canonical SITEBORNE service and major version to price; selects that service’s governed pricing key, contract release, and production resource URL. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"service_id",
"scheme",
"input"
],
"properties": {
"input": {
"description": "Complete proposed input for the selected service; its canonical hash binds the quote and later payment requirement to this exact request content."
},
"scheme": {
"enum": [
"exact",
"upto"
],
"type": "string",
"description": "Pricing mode: exact fixes the required amount, while upto authorizes a maximum whose eventual charge cannot exceed the returned amount."
},
"service_id": {
"enum": [
"company_evidence_graph.v1",
"web_context_verified.v1",
"document_evidence_json.v1",
"verify_agent_output.v1",
"company_evidence_graph.v2",
"web_context_verified.v2",
"document_evidence_json.v2",
"verify_agent_output.v2",
"company_evidence_graph.v3",
"web_context_verified.v3",
"document_evidence_json.v3",
"verify_agent_output.v3"
],
"type": "string",
"description": "Canonical SITEBORNE service and major version to price; selects that service’s governed pricing key, contract release, and production resource URL."
}
},
"additionalProperties": false
}| Public HTTP or HTTPS URL to retrieve and verify; private, loopback, and otherwise unsafe network destinations are rejected. |
| locale_hint | string | Optional BCP 47 language or language-region hint used for HTTP content negotiation; it does not translate content. |
| output_mode | string | Result representation: clean_text normalizes prose, markdown preserves document structure, and structured validates selected fields against buyer_schema. |
| buyer_schema | object | Optional JSON Schema governing structured output; meaningful only with output_mode structured and bounded to fifty properties and depth five. |
| max_redirects | integer | Maximum redirect hops from 0 through 10 when the selected redirect policy follows redirects. |
| retrieval_mode* | string | Retrieval mode. Only direct (plain HTTP retrieval, no JavaScript execution) is available. rendered has a governed price but is not available: it is rejected with retrieval_mode_unavailable before any payment challenge and is never substituted with direct retrieval. |
| field_selectors | array | Up to thirty requested field names for structured extraction; narrows the structured result rather than changing the fetched URL. |
| redirect_policy | string | Redirect handling: follow permits the bounded chain, follow_first permits only the first hop, and manual returns redirect evidence without following. |
| max_content_size | integer | Maximum returned content size in bytes, from 1,024 through 10,485,760; smaller limits truncate or reject oversized content sooner. |
| freshness_seconds | integer | Maximum acceptable cached-content age in seconds, from 0 through 2,592,000; zero requests uncached content. |
| maximum_authorized_price | object | Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never changes retrieval scope. |
| minimum_verification_score | number | Required PCC verification ratio from 0 through 1; raising it makes evidence acceptance stricter. |
{
"$id": "https://siteborne.net/schemas/services/web-context-input.schema.json",
"type": "object",
"title": "Verified Web Context Input",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"examples": [
{
"target_url": "https://acme.example.com/about",
"output_mode": "markdown",
"retrieval_mode": "direct",
"freshness_seconds": 3600,
"maximum_authorized_price": {
"amount": "0.029",
"currency": "USD"
}
}
],
"required": [
"target_url",
"retrieval_mode"
],
"properties": {
"target_url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Public HTTP or HTTPS URL to retrieve and verify; private, loopback, and otherwise unsafe network destinations are rejected."
},
"locale_hint": {
"type": "string",
"pattern": "^[a-z]{2}(-[A-Z]{2})?$",
"description": "Optional BCP 47 language or language-region hint used for HTTP content negotiation; it does not translate content."
},
"output_mode": {
"enum": [
"clean_text",
"markdown",
"structured"
],
"type": "string",
"default": "clean_text",
"description": "Result representation: clean_text normalizes prose, markdown preserves document structure, and structured validates selected fields against buyer_schema."
},
"buyer_schema": {
"type": "object",
"maxDepth": 5,
"description": "Optional JSON Schema governing structured output; meaningful only with output_mode structured and bounded to fifty properties and depth five.",
"maxProperties": 50,
"additionalProperties": true
},
"max_redirects": {
"type": "integer",
"default": 5,
"maximum": 10,
"minimum": 0,
"description": "Maximum redirect hops from 0 through 10 when the selected redirect policy follows redirects."
},
"retrieval_mode": {
"enum": [
"direct",
"rendered"
],
"type": "string",
"description": "Retrieval mode. Only direct (plain HTTP retrieval, no JavaScript execution) is available. rendered has a governed price but is not available: it is rejected with retrieval_mode_unavailable before any payment challenge and is never substituted with direct retrieval."
},
"field_selectors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 128
},
"maxItems": 30,
"description": "Up to thirty requested field names for structured extraction; narrows the structured result rather than changing the fetched URL."
},
"redirect_policy": {
"enum": [
"follow",
"follow_first",
"manual"
],
"type": "string",
"default": "follow",
"description": "Redirect handling: follow permits the bounded chain, follow_first permits only the first hop, and manual returns redirect evidence without following."
},
"max_content_size": {
"type": "integer",
"default": 1048576,
"maximum": 10485760,
"minimum": 1024,
"description": "Maximum returned content size in bytes, from 1,024 through 10,485,760; smaller limits truncate or reject oversized content sooner."
},
"freshness_seconds": {
"type": "integer",
"default": 3600,
"maximum": 2592000,
"minimum": 0,
"description": "Maximum acceptable cached-content age in seconds, from 0 through 2,592,000; zero requests uncached content."
},
"maximum_authorized_price": {
"type": "object",
"title": "Decimal Money",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"asset": "USDC",
"amount": "0.19",
"network": "base-mainnet",
"currency": "USD"
}
],
"required": [
"amount",
"currency"
],
"properties": {
"asset": {
"type": "string",
"pattern": "^[A-Z0-9]{3,10}$",
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."
},
"amount": {
"type": "string",
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."
},
"network": {
"type": "string",
"pattern": "^[a-z0-9-]+$",
"maxLength": 64,
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."
},
"currency": {
"enum": [
"USD"
],
"type": "string",
"default": "USD",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code."
},
"precision": {
"type": "integer",
"default": 6,
"maximum": 18,
"minimum": 0,
"description": "Maximum decimal places supported by the asset/network. Metadata only."
}
},
"description": "Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never changes retrieval scope.",
"additionalProperties": false
},
"minimum_verification_score": {
"type": "number",
"default": 0.7,
"maximum": 1,
"minimum": 0,
"description": "Required PCC verification ratio from 0 through 1; raising it makes evidence acceptance stricter."
}
},
"description": "Input schema for web_context_verified.v1 service. Supports direct and rendered retrieval modes.",
"additionalProperties": false
}| Public HTTP or HTTPS URL to retrieve and verify; private, loopback, and otherwise unsafe network destinations are rejected. |
| locale_hint | string | Optional BCP 47 language or language-region hint used for HTTP content negotiation; it does not translate content. |
| output_mode | string | Result representation: clean_text normalizes prose, markdown preserves document structure, and structured validates selected fields against buyer_schema. |
| buyer_schema | object | Optional JSON Schema governing structured output; meaningful only with output_mode structured and bounded to fifty properties and depth five. |
| max_redirects | integer | Maximum redirect hops from 0 through 10 when the selected redirect policy follows redirects. |
| retrieval_mode* | string | Retrieval mode. Only direct (plain HTTP retrieval, no JavaScript execution) is available. rendered has a governed price but is not available: it is rejected with retrieval_mode_unavailable before any payment challenge and is never substituted with direct retrieval. |
| field_selectors | array | Up to thirty requested field names for structured extraction; narrows the structured result rather than changing the fetched URL. |
| redirect_policy | string | Redirect handling: follow permits the bounded chain, follow_first permits only the first hop, and manual returns redirect evidence without following. |
| max_content_size | integer | Maximum returned content size in bytes, from 1,024 through 10,485,760; smaller limits truncate or reject oversized content sooner. |
| freshness_seconds | integer | Maximum acceptable cached-content age in seconds, from 0 through 2,592,000; zero requests uncached content. |
| maximum_authorized_price | object | Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never changes retrieval scope. |
| minimum_verification_score | number | Required PCC verification ratio from 0 through 1; raising it makes evidence acceptance stricter. |
{
"$id": "https://siteborne.net/schemas/services/web-context-input.schema.json",
"type": "object",
"title": "Verified Web Context Input",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"examples": [
{
"target_url": "https://acme.example.com/about",
"output_mode": "markdown",
"retrieval_mode": "direct",
"freshness_seconds": 3600,
"maximum_authorized_price": {
"amount": "0.029",
"currency": "USD"
}
}
],
"required": [
"target_url",
"retrieval_mode"
],
"properties": {
"target_url": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Public HTTP or HTTPS URL to retrieve and verify; private, loopback, and otherwise unsafe network destinations are rejected."
},
"locale_hint": {
"type": "string",
"pattern": "^[a-z]{2}(-[A-Z]{2})?$",
"description": "Optional BCP 47 language or language-region hint used for HTTP content negotiation; it does not translate content."
},
"output_mode": {
"enum": [
"clean_text",
"markdown",
"structured"
],
"type": "string",
"default": "clean_text",
"description": "Result representation: clean_text normalizes prose, markdown preserves document structure, and structured validates selected fields against buyer_schema."
},
"buyer_schema": {
"type": "object",
"maxDepth": 5,
"description": "Optional JSON Schema governing structured output; meaningful only with output_mode structured and bounded to fifty properties and depth five.",
"maxProperties": 50,
"additionalProperties": true
},
"max_redirects": {
"type": "integer",
"default": 5,
"maximum": 10,
"minimum": 0,
"description": "Maximum redirect hops from 0 through 10 when the selected redirect policy follows redirects."
},
"retrieval_mode": {
"enum": [
"direct",
"rendered"
],
"type": "string",
"description": "Retrieval mode. Only direct (plain HTTP retrieval, no JavaScript execution) is available. rendered has a governed price but is not available: it is rejected with retrieval_mode_unavailable before any payment challenge and is never substituted with direct retrieval."
},
"field_selectors": {
"type": "array",
"items": {
"type": "string",
"maxLength": 128
},
"maxItems": 30,
"description": "Up to thirty requested field names for structured extraction; narrows the structured result rather than changing the fetched URL."
},
"redirect_policy": {
"enum": [
"follow",
"follow_first",
"manual"
],
"type": "string",
"default": "follow",
"description": "Redirect handling: follow permits the bounded chain, follow_first permits only the first hop, and manual returns redirect evidence without following."
},
"max_content_size": {
"type": "integer",
"default": 1048576,
"maximum": 10485760,
"minimum": 1024,
"description": "Maximum returned content size in bytes, from 1,024 through 10,485,760; smaller limits truncate or reject oversized content sooner."
},
"freshness_seconds": {
"type": "integer",
"default": 3600,
"maximum": 2592000,
"minimum": 0,
"description": "Maximum acceptable cached-content age in seconds, from 0 through 2,592,000; zero requests uncached content."
},
"maximum_authorized_price": {
"type": "object",
"title": "Decimal Money",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"asset": "USDC",
"amount": "0.19",
"network": "base-mainnet",
"currency": "USD"
}
],
"required": [
"amount",
"currency"
],
"properties": {
"asset": {
"type": "string",
"pattern": "^[A-Z0-9]{3,10}$",
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."
},
"amount": {
"type": "string",
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."
},
"network": {
"type": "string",
"pattern": "^[a-z0-9-]+$",
"maxLength": 64,
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."
},
"currency": {
"enum": [
"USD"
],
"type": "string",
"default": "USD",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code."
},
"precision": {
"type": "integer",
"default": 6,
"maximum": 18,
"minimum": 0,
"description": "Maximum decimal places supported by the asset/network. Metadata only."
}
},
"description": "Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never changes retrieval scope.",
"additionalProperties": false
},
"minimum_verification_score": {
"type": "number",
"default": 0.7,
"maximum": 1,
"minimum": 0,
"description": "Required PCC verification ratio from 0 through 1; raising it makes evidence acceptance stricter."
}
},
"description": "Input schema for web_context_verified.v1 service. Supports direct and rendered retrieval modes.",
"additionalProperties": false
}| required_schema* | object | JSON Schema the candidate output must satisfy; it constrains validation and cannot change SITEBORNE verifier policy. |
| candidate_output* | object | Agent-produced JSON object to evaluate, bounded to 200 properties and depth 10; it is evidence under test, not trusted policy. |
| supplied_evidence | array | Up to twenty evidence objects supplied with the candidate output and bound to integrity hashes. |
| verification_mode* | string | Verification mode. Only standard (deterministic checks of the supplied material, no outbound retrieval) is available. independent_reproduction has a governed price but is not available: it is rejected with verification_mode_unavailable before any payment challenge and is never downgraded to standard. |
| verification_contract* | object | Complete set of claims and deterministic checks against which the supplied candidate output is evaluated. |
| freshness_requirements | object | Optional maximum-age limits for evidence and schemas, each expressed in seconds. |
| allowed_evidence_sources | array | Up to ten permitted evidence source URIs; evidence outside this allowlist cannot satisfy source restrictions. |
| maximum_authorized_price | object | Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never relaxes verification policy. |
{
"$id": "https://siteborne.net/schemas/services/agent-verification-input.schema.json",
"type": "object",
"title": "Agent Output Verification Input",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"examples": [
{
"required_schema": {
"type": "object",
"required": [
"company"
],
"properties": {
"company": {
"type": "string"
}
}
},
"candidate_output": {
"company": "Acme Corp",
"confidence": 0.95
},
"verification_mode": "standard",
"verification_contract": {
"claims": [
{
"claim_id": "claim_1",
"predicate": "equals",
"materiality": "material",
"expected_value": "Acme Corp"
}
],
"deterministic_requirements": [
{
"check": "schema_valid",
"requirement_id": "req_1"
},
{
"check": "evidence_resolves",
"requirement_id": "req_2"
}
]
},
"maximum_authorized_price": {
"amount": "0.019",
"currency": "USD"
}
}
],
"required": [
"verification_contract",
"candidate_output",
"required_schema",
"verification_mode"
],
"properties": {
"minimum_score": {
"type": "number",
"default": 0.7,
"maximum": 1,
"minimum": 0,
"description": "Minimum overall verification score from 0 through 1; raising it makes the final acceptance verdict stricter."
},
"required_schema": {
"type": "object",
"description": "JSON Schema the candidate output must satisfy; it constrains validation and cannot change SITEBORNE verifier policy.",
"additionalProperties": true
},
"candidate_output": {
"type": "object",
"maxDepth": 10,
"description": "Agent-produced JSON object to evaluate, bounded to 200 properties and depth 10; it is evidence under test, not trusted policy.",
"maxProperties": 200,
"additionalProperties": true
},
"supplied_evidence": {
"type": "array",
"items": {
"type": "object",
"required": [
"evidence_id",
"content",
"content_hash"
],
"properties": {
"content": {
"type": "object",
"description": "JSON evidence content whose integrity must agree with content_hash; it is treated as untrusted input.",
"additionalProperties": true
},
"source_uri": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Optional public source URI, up to 2,048 characters, identifying where the evidence was obtained."
},
"evidence_id": {
"type": "string",
"maxLength": 64,
"description": "Caller-stable evidence identifier up to 64 characters, used to connect claims to this evidence item."
},
"content_hash": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$",
"description": "Lowercase SHA-256 integrity identifier in sha256:<64 hex> form for the supplied content."
},
"retrieved_at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"description": "Optional UTC retrieval timestamp in the schema’s RFC 3339 form, used by freshness checks."
}
},
"additionalProperties": false
},
"maxItems": 20,
"description": "Up to twenty evidence objects supplied with the candidate output and bound to integrity hashes."
},
"verification_mode": {
"enum": [
"standard",
"independent_reproduction"
],
"type": "string",
"description": "Verification mode. Only standard (deterministic checks of the supplied material, no outbound retrieval) is available. independent_reproduction has a governed price but is not available: it is rejected with verification_mode_unavailable before any payment challenge and is never downgraded to standard."
},
"verification_contract": {
"type": "object",
"required": [
"claims",
"deterministic_requirements"
],
"properties": {
"claims": {
"type": "array",
"items": {
"type": "object",
"required": [
"claim_id",
"predicate",
"expected_value"
],
"properties": {
"claim_id": {
"type": "string",
"maxLength": 64,
"description": "Caller-stable claim identifier up to 64 characters, used to correlate the verdict for this claim."
},
"predicate": {
"enum": [
"equals",
"contains",
"matches",
"greater_than",
"less_than",
"exists",
"not_exists"
],
"type": "string",
"description": "Comparison operation applied to the candidate value: equality, containment, pattern, ordering, existence, or nonexistence."
},
"tolerance": {
"type": "number",
"minimum": 0,
"description": "Optional nonnegative numeric tolerance for comparisons where bounded deviation is acceptable."
},
"materiality": {
"enum": [
"material",
"supporting",
"contextual"
],
"type": "string",
"default": "material",
"description": "Claim importance—material, supporting, or contextual—which affects how the verdict weighs a failed claim."
},
"expected_value": {
"type": [
"string",
"number",
"boolean",
"object",
"array",
"null"
],
"description": "Expected JSON value interpreted by the selected predicate; its shape should match the claim being tested."
}
},
"additionalProperties": false
},
"maxItems": 50,
"description": "Up to fifty expected claims; each binds a stable claim identifier to a predicate, expected value, and optional tolerance/materiality."
},
"deterministic_requirements": {
"type": "array",
"items": {
"type": "object",
"required": [
"requirement_id",
"check"
],
"properties": {
"check": {
"enum": [
"schema_valid",
"hash_match",
"signature_valid",
"evidence_resolves",
"no_pii",
"no_secrets"
],
"type": "string",
"description": "Closed deterministic check to run: schema, hash, signature, evidence resolution, PII absence, or secret absence."
},
"parameters": {
"type": "object",
"description": "Check-specific configuration interpreted only by the selected deterministic check; it cannot modify verifier policy.",
"additionalProperties": true
},
"requirement_id": {
"type": "string",
"maxLength": 64,
"description": "Caller-stable requirement identifier up to 64 characters, used to correlate the deterministic check result."
}
},
"additionalProperties": false
},
"maxItems": 30,
"description": "Up to thirty deterministic checks for schema, hashes, signatures, evidence resolution, PII, or secrets."
}
},
"description": "Complete set of claims and deterministic checks against which the supplied candidate output is evaluated.",
"additionalProperties": false
},
"freshness_requirements": {
"type": "object",
"properties": {
"schema_max_age_seconds": {
"type": "integer",
"maximum": 2592000,
"minimum": 0,
"description": "Maximum schema age in seconds from 0 through 2,592,000; older schemas fail freshness requirements."
},
"evidence_max_age_seconds": {
"type": "integer",
"maximum": 2592000,
"minimum": 0,
"description": "Maximum evidence age in seconds from 0 through 2,592,000; older evidence fails freshness requirements."
}
},
"description": "Optional maximum-age limits for evidence and schemas, each expressed in seconds.",
"additionalProperties": false
},
"allowed_evidence_sources": {
"type": "array",
"items": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"maxItems": 10,
"description": "Up to ten permitted evidence source URIs; evidence outside this allowlist cannot satisfy source restrictions."
},
"maximum_authorized_price": {
"type": "object",
"title": "Decimal Money",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"asset": "USDC",
"amount": "0.19",
"network": "base-mainnet",
"currency": "USD"
}
],
"required": [
"amount",
"currency"
],
"properties": {
"asset": {
"type": "string",
"pattern": "^[A-Z0-9]{3,10}$",
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."
},
"amount": {
"type": "string",
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."
},
"network": {
"type": "string",
"pattern": "^[a-z0-9-]+$",
"maxLength": 64,
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."
},
"currency": {
"enum": [
"USD"
],
"type": "string",
"default": "USD",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code."
},
"precision": {
"type": "integer",
"default": 6,
"maximum": 18,
"minimum": 0,
"description": "Maximum decimal places supported by the asset/network. Metadata only."
}
},
"description": "Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never relaxes verification policy.",
"additionalProperties": false
}
},
"description": "Input schema for verify_agent_output.v1 service. Supports standard and independent reproduction modes.",
"additionalProperties": false
}| required_schema* | object | JSON Schema the candidate output must satisfy; it constrains validation and cannot change SITEBORNE verifier policy. |
| candidate_output* | object | Agent-produced JSON object to evaluate, bounded to 200 properties and depth 10; it is evidence under test, not trusted policy. |
| supplied_evidence | array | Up to twenty evidence objects supplied with the candidate output and bound to integrity hashes. |
| verification_mode* | string | Verification mode. Only standard (deterministic checks of the supplied material, no outbound retrieval) is available. independent_reproduction has a governed price but is not available: it is rejected with verification_mode_unavailable before any payment challenge and is never downgraded to standard. |
| verification_contract* | object | Complete set of claims and deterministic checks against which the supplied candidate output is evaluated. |
| freshness_requirements | object | Optional maximum-age limits for evidence and schemas, each expressed in seconds. |
| allowed_evidence_sources | array | Up to ten permitted evidence source URIs; evidence outside this allowlist cannot satisfy source restrictions. |
| maximum_authorized_price | object | Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never relaxes verification policy. |
{
"$id": "https://siteborne.net/schemas/services/agent-verification-input.schema.json",
"type": "object",
"title": "Agent Output Verification Input",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"examples": [
{
"required_schema": {
"type": "object",
"required": [
"company"
],
"properties": {
"company": {
"type": "string"
}
}
},
"candidate_output": {
"company": "Acme Corp",
"confidence": 0.95
},
"verification_mode": "standard",
"verification_contract": {
"claims": [
{
"claim_id": "claim_1",
"predicate": "equals",
"materiality": "material",
"expected_value": "Acme Corp"
}
],
"deterministic_requirements": [
{
"check": "schema_valid",
"requirement_id": "req_1"
},
{
"check": "evidence_resolves",
"requirement_id": "req_2"
}
]
},
"maximum_authorized_price": {
"amount": "0.019",
"currency": "USD"
}
}
],
"required": [
"verification_contract",
"candidate_output",
"required_schema",
"verification_mode"
],
"properties": {
"minimum_score": {
"type": "number",
"default": 0.7,
"maximum": 1,
"minimum": 0,
"description": "Minimum overall verification score from 0 through 1; raising it makes the final acceptance verdict stricter."
},
"required_schema": {
"type": "object",
"description": "JSON Schema the candidate output must satisfy; it constrains validation and cannot change SITEBORNE verifier policy.",
"additionalProperties": true
},
"candidate_output": {
"type": "object",
"maxDepth": 10,
"description": "Agent-produced JSON object to evaluate, bounded to 200 properties and depth 10; it is evidence under test, not trusted policy.",
"maxProperties": 200,
"additionalProperties": true
},
"supplied_evidence": {
"type": "array",
"items": {
"type": "object",
"required": [
"evidence_id",
"content",
"content_hash"
],
"properties": {
"content": {
"type": "object",
"description": "JSON evidence content whose integrity must agree with content_hash; it is treated as untrusted input.",
"additionalProperties": true
},
"source_uri": {
"type": "string",
"format": "uri",
"maxLength": 2048,
"description": "Optional public source URI, up to 2,048 characters, identifying where the evidence was obtained."
},
"evidence_id": {
"type": "string",
"maxLength": 64,
"description": "Caller-stable evidence identifier up to 64 characters, used to connect claims to this evidence item."
},
"content_hash": {
"type": "string",
"pattern": "^sha256:[a-f0-9]{64}$",
"description": "Lowercase SHA-256 integrity identifier in sha256:<64 hex> form for the supplied content."
},
"retrieved_at": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d{1,6})?Z$",
"description": "Optional UTC retrieval timestamp in the schema’s RFC 3339 form, used by freshness checks."
}
},
"additionalProperties": false
},
"maxItems": 20,
"description": "Up to twenty evidence objects supplied with the candidate output and bound to integrity hashes."
},
"verification_mode": {
"enum": [
"standard",
"independent_reproduction"
],
"type": "string",
"description": "Verification mode. Only standard (deterministic checks of the supplied material, no outbound retrieval) is available. independent_reproduction has a governed price but is not available: it is rejected with verification_mode_unavailable before any payment challenge and is never downgraded to standard."
},
"verification_contract": {
"type": "object",
"required": [
"claims",
"deterministic_requirements"
],
"properties": {
"claims": {
"type": "array",
"items": {
"type": "object",
"required": [
"claim_id",
"predicate",
"expected_value"
],
"properties": {
"claim_id": {
"type": "string",
"maxLength": 64,
"description": "Caller-stable claim identifier up to 64 characters, used to correlate the verdict for this claim."
},
"predicate": {
"enum": [
"equals",
"contains",
"matches",
"greater_than",
"less_than",
"exists",
"not_exists"
],
"type": "string",
"description": "Comparison operation applied to the candidate value: equality, containment, pattern, ordering, existence, or nonexistence."
},
"tolerance": {
"type": "number",
"minimum": 0,
"description": "Optional nonnegative numeric tolerance for comparisons where bounded deviation is acceptable."
},
"materiality": {
"enum": [
"material",
"supporting",
"contextual"
],
"type": "string",
"default": "material",
"description": "Claim importance—material, supporting, or contextual—which affects how the verdict weighs a failed claim."
},
"expected_value": {
"type": [
"string",
"number",
"boolean",
"object",
"array",
"null"
],
"description": "Expected JSON value interpreted by the selected predicate; its shape should match the claim being tested."
}
},
"additionalProperties": false
},
"maxItems": 50,
"description": "Up to fifty expected claims; each binds a stable claim identifier to a predicate, expected value, and optional tolerance/materiality."
},
"deterministic_requirements": {
"type": "array",
"items": {
"type": "object",
"required": [
"requirement_id",
"check"
],
"properties": {
"check": {
"enum": [
"schema_valid",
"hash_match",
"signature_valid",
"evidence_resolves",
"no_pii",
"no_secrets"
],
"type": "string",
"description": "Closed deterministic check to run: schema, hash, signature, evidence resolution, PII absence, or secret absence."
},
"parameters": {
"type": "object",
"description": "Check-specific configuration interpreted only by the selected deterministic check; it cannot modify verifier policy.",
"additionalProperties": true
},
"requirement_id": {
"type": "string",
"maxLength": 64,
"description": "Caller-stable requirement identifier up to 64 characters, used to correlate the deterministic check result."
}
},
"additionalProperties": false
},
"maxItems": 30,
"description": "Up to thirty deterministic checks for schema, hashes, signatures, evidence resolution, PII, or secrets."
}
},
"description": "Complete set of claims and deterministic checks against which the supplied candidate output is evaluated.",
"additionalProperties": false
},
"freshness_requirements": {
"type": "object",
"properties": {
"schema_max_age_seconds": {
"type": "integer",
"maximum": 2592000,
"minimum": 0,
"description": "Maximum schema age in seconds from 0 through 2,592,000; older schemas fail freshness requirements."
},
"evidence_max_age_seconds": {
"type": "integer",
"maximum": 2592000,
"minimum": 0,
"description": "Maximum evidence age in seconds from 0 through 2,592,000; older evidence fails freshness requirements."
}
},
"description": "Optional maximum-age limits for evidence and schemas, each expressed in seconds.",
"additionalProperties": false
},
"allowed_evidence_sources": {
"type": "array",
"items": {
"type": "string",
"format": "uri",
"maxLength": 2048
},
"maxItems": 10,
"description": "Up to ten permitted evidence source URIs; evidence outside this allowlist cannot satisfy source restrictions."
},
"maximum_authorized_price": {
"type": "object",
"title": "Decimal Money",
"examples": [
{
"amount": "0.039",
"currency": "USD"
},
{
"asset": "USDC",
"amount": "0.19",
"network": "base-mainnet",
"currency": "USD"
}
],
"required": [
"amount",
"currency"
],
"properties": {
"asset": {
"type": "string",
"pattern": "^[A-Z0-9]{3,10}$",
"description": "Payment asset identifier (e.g., 'USDC', 'ETH'). Optional for non-payment contexts."
},
"amount": {
"type": "string",
"pattern": "^(0|[1-9][0-9]*)(\\.[0-9]{1,18})?$",
"examples": [
"0",
"0.009",
"0.012",
"0.019",
"0.029",
"0.039",
"0.049",
"0.19"
],
"description": "Canonical decimal string. No scientific notation, no leading zeros (except single '0'), no trailing zeros unless significant, no sign. Maximum 18 decimal places."
},
"network": {
"type": "string",
"pattern": "^[a-z0-9-]+$",
"maxLength": 64,
"description": "Payment network identifier (e.g., 'base-mainnet', 'base-sepolia'). Optional for non-payment contexts."
},
"currency": {
"enum": [
"USD"
],
"type": "string",
"default": "USD",
"pattern": "^[A-Z]{3}$",
"description": "ISO 4217 currency code."
},
"precision": {
"type": "integer",
"default": 6,
"maximum": 18,
"minimum": 0,
"description": "Maximum decimal places supported by the asset/network. Metadata only."
}
},
"description": "Buyer’s decimal-safe maximum authorized price; constrains the payment requirement and never relaxes verification policy.",
"additionalProperties": false
}
},
"description": "Input schema for verify_agent_output.v1 service. Supports standard and independent reproduction modes.",
"additionalProperties": false
}