zFinia Intelligence

{'type': 'object', 'required': ['foreground', 'background', 'large_text'], 'properties': {'background': {'type': 'string', 'example': '#ffffff', 'pattern': '^#[0-9a-fA-F]{6}$'}, 'foreground': {'type': 'string', 'example': '#000000', 'pattern': '^#[0-9a-fA-F]{6}$'}, 'large_text': {'type': 'boolean', 'example': False}}, 'additionalProperties': False}

{'type': 'object', 'required': ['request_id', 'service_id', 'service_version', 'contrast_ratio', 'wcag_aa', 'wcag_aaa', 'large_text', 'limitations'], 'properties': {'wcag_aa': {'type': 'boolean'}, 'wcag_aaa': {'type': 'boolean'}, 'large_text': {'type': 'boolean'}, 'request_id': {'type': 'string', 'description': 'Delivery request identifier; also returned in x-foundry-request-id.'}, 'service_id': {'type': 'string', 'description': 'Canonical service identifier.'}, 'limitations': {'type': 'array'}, 'contrast_ratio': {'type': 'number'}, 'service_version': {'type': 'string', 'description': 'Version of the invoked service.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['source_fields', 'target_fields'], 'properties': {'source_fields': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'type', 'required', 'nullable'], 'properties': {'name': {'type': 'string', 'pattern': '^[A-Za-z][A-Za-z0-9_]{0,63}$'}, 'type': {'enum': ['string', 'number', 'integer', 'boolean', 'object', 'array'], 'type': 'string'}, 'nullable': {'type': 'boolean'}, 'required': {'type': 'boolean'}}, 'additionalProperties': False}, 'example': [{'name': 'order_id', 'type': 'string', 'nullable': False, 'required': True}, {'name': 'customer_id', 'type': 'string', 'nullable': True, 'required': True}, {'name': 'amount_cents', 'type': 'string', 'nullable': False, 'required': True}, {'name': 'created_at', 'type': 'string', 'nullable': False, 'required': True}], 'maxItems': 100, 'minItems': 1}, 'target_fields': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'type', 'required', 'nullable'], 'properties': {'name': {'type': 'string', 'pattern': '^[A-Za-z][A-Za-z0-9_]{0,63}$'}, 'type': {'enum': ['string', 'number', 'integer', 'boolean', 'object', 'array'], 'type': 'string'}, 'nullable': {'type': 'boolean'}, 'required': {'type': 'boolean'}}, 'additionalProperties': False}, 'example': [{'name': 'order_id', 'type': 'string', 'nullable': False, 'required': True}, {'name': 'customer_id', 'type': 'string', 'nullable': False, 'required': True}, {'name': 'amount_cents', 'type': 'integer', 'nullable': False, 'required': True}, {'name': 'currency', 'type': 'string', 'nullable': False, 'required': True}, {'name': 'created_at', 'type': 'string', 'nullable': False, 'required': True}], 'maxItems': 100, 'minItems': 1}, 'comparison_mode': {'enum': ['backward_compatible', 'exact'], 'type': 'string', 'example': 'backward_compatible'}, 'canonicalization': {'enum': ['exact', 'ascii_case_insensitive'], 'type': 'string', 'example': 'exact'}, 'contract_version': {'enum': ['1'], 'type': 'string', 'example': '1'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['request_id', 'service_id', 'service_version', 'contract_version', 'comparison_mode', 'canonicalization', 'compatible', 'issue_count', 'issues', 'remediations', 'checked_source_fields', 'checked_target_fields', 'assumptions', 'limitations'], 'properties': {'issues': {'type': 'array'}, 'compatible': {'type': 'boolean'}, 'request_id': {'type': 'string', 'description': 'Delivery request identifier; also returned in x-foundry-request-id.'}, 'service_id': {'type': 'string', 'description': 'Canonical service identifier.'}, 'assumptions': {'type': 'array'}, 'issue_count': {'type': 'integer'}, 'limitations': {'type': 'array'}, 'remediations': {'type': 'array'}, 'comparison_mode': {'type': 'string'}, 'service_version': {'type': 'string', 'description': 'Version of the invoked service.'}, 'canonicalization': {'type': 'object'}, 'contract_version': {'type': 'string'}, 'checked_source_fields': {'type': 'integer'}, 'checked_target_fields': {'type': 'integer'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['objective'], 'properties': {'inputs': {'type': 'object', 'example': {'background': '#ffffff', 'foreground': '#000000', 'large_text': False}, 'description': 'Caller-supplied facts required to produce the outcome. Do not send secrets or ask Foundry to fetch URLs.', 'additionalProperties': True}, 'latency': {'enum': ['any', 'interactive', 'batch'], 'type': 'string', 'example': 'interactive'}, 'evidence': {'enum': ['any', 'deterministic', 'sourced'], 'type': 'string', 'example': 'deterministic'}, 'freshness': {'enum': ['any', 'cached_ok', 'current_public'], 'type': 'string', 'example': 'any'}, 'max_price': {'type': 'string', 'pattern': '^[1-9][0-9]{0,11}$', 'description': 'Optional maximum USDC atomic units the buyer will pay.'}, 'objective': {'type': 'string', 'example': 'Calculate WCAG 2.x sRGB contrast for this colour pair and return aa/aaa evidence.', 'maxLength': 2000, 'minLength': 1, 'description': 'Outcome the buyer needs. Foundry chooses the execution plan; do not describe supplier topology. goal, task, outcome, and query are accepted aliases. Product names, service IDs, and live routes are valid outcomes. Well-known capability fields sent at the top level are folded into inputs. fg/bg alias foreground/background. #RRGGBB pairs in the objective are used as contrast inputs when inputs.foreground/background are omitted.'}, 'buyer_metadata': {'type': 'object', 'description': 'Optional non-secret buyer hints. Secret-like keys are stripped and never persisted.', 'additionalProperties': True}, 'required_output': {'type': 'object', 'description': 'Optional desired output shape or fields.', 'additionalProperties': True}, 'preferred_protocol': {'enum': ['any', 'x402', 'http-402', 'mcp'], 'type': 'string', 'example': 'x402'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['status', 'execution_id', 'outcome', 'result', 'evidence', 'economics', 'limitations'], 'properties': {'plan': {'type': 'object'}, 'result': {'type': 'object'}, 'status': {'type': 'string'}, 'outcome': {'type': 'string'}, 'evidence': {'type': 'object'}, 'economics': {'type': 'object'}, 'value_add': {'type': 'object'}, 'latency_ms': {'type': 'number'}, 'limitations': {'type': 'array'}, 'execution_id': {'type': 'string'}, 'request_fingerprint': {'type': 'string'}}, 'additionalProperties': True}

{'type': 'object', 'anyOf': [{'required': ['cursor']}, {'required': ['since']}], 'properties': {'since': {'type': 'string', 'maxLength': 2048, 'minLength': 1, 'description': 'Alias of cursor. Use the previous nextCursor so only later material changes are returned.'}, 'cursor': {'type': 'string', 'example': '2026-09-01T00:00:00.000Z', 'maxLength': 2048, 'minLength': 1, 'description': 'Previous nextCursor (opaque or ISO-8601). Required for the paid delta unless since is set. Pass this back on the next poll.'}, 'maxItems': {'type': 'integer', 'example': 3, 'maximum': 50, 'minimum': 1}, 'include_high_resolution': {'type': 'boolean', 'example': True, 'description': 'When true, paid items include full evidence fields already present on the public newswire item.'}}, 'description': 'Paid delta for a caller that already has a zFinia cursor. Supply cursor or since (the previous nextCursor).', 'additionalProperties': False}

{'type': 'object', 'required': ['request_id', 'service_id', 'service_version', 'schema', 'generatedAt', 'since', 'nextCursor', 'count', 'items', 'truncated', 'usageRights'], 'properties': {'count': {'type': 'integer'}, 'items': {'type': 'array'}, 'since': {'type': 'string'}, 'schema': {'type': 'string'}, 'product': {'type': 'string'}, 'truncated': {'type': 'boolean'}, 'nextCursor': {'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Delivery request identifier; also returned in x-foundry-request-id.'}, 'service_id': {'type': 'string', 'description': 'Canonical service identifier.'}, 'generatedAt': {'type': 'string'}, 'priceAtomic': {'type': 'string'}, 'usageRights': {'type': 'string'}, 'schemaVersion': {'type': 'string'}, 'highResolution': {'type': 'boolean'}, 'marketMovements': {'type': 'object'}, 'service_version': {'type': 'string', 'description': 'Version of the invoked service.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['merchant_service_id', 'baseline', 'current', 'policy'], 'properties': {'policy': {'type': 'object', 'example': {'require_same_asset': True, 'require_same_pay_to': True, 'maximum_price_atomic': '15000', 'require_same_network': True}, 'required': ['maximum_price_atomic', 'require_same_network', 'require_same_asset', 'require_same_pay_to'], 'properties': {'require_same_asset': {'type': 'boolean'}, 'require_same_pay_to': {'type': 'boolean'}, 'maximum_price_atomic': {'type': 'string', 'pattern': '^[0-9]{1,18}$'}, 'require_same_network': {'type': 'boolean'}}, 'additionalProperties': False}, 'current': {'type': 'object', 'example': {'asset': '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', 'route': '/v1/weather', 'method': 'POST', 'pay_to': '0x1111111111111111111111111111111111111111', 'network': 'eip155:8453', 'observed_at': '2026-09-19T00:00:00.000Z', 'input_fields': [{'name': 'city', 'type': 'string', 'nullable': False, 'required': True}], 'price_atomic': '10000', 'output_fields': [{'name': 'temperature', 'type': 'number', 'nullable': False, 'required': True}]}, 'required': ['observed_at', 'route', 'method', 'price_atomic', 'network', 'asset', 'pay_to', 'input_fields', 'output_fields'], 'properties': {'asset': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'route': {'type': 'string', 'pattern': "^/[A-Za-z0-9._~!$&'()*+,;=:@%/-]{0,255}$", 'maxLength': 256, 'minLength': 1}, 'method': {'enum': ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'], 'type': 'string'}, 'pay_to': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'network': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'observed_at': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T', 'maxLength': 40}, 'input_fields': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'type', 'required', 'nullable'], 'properties': {'name': {'type': 'string', 'pattern': '^[A-Za-z][A-Za-z0-9_]{0,63}$'}, 'type': {'enum': ['string', 'number', 'integer', 'boolean', 'object', 'array'], 'type': 'string'}, 'nullable': {'type': 'boolean'}, 'required': {'type': 'boolean'}}, 'additionalProperties': False}, 'maxItems': 100, 'minItems': 1}, 'price_atomic': {'type': 'string', 'pattern': '^[0-9]{1,18}$'}, 'output_fields': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'type', 'required', 'nullable'], 'properties': {'name': {'type': 'string', 'pattern': '^[A-Za-z][A-Za-z0-9_]{0,63}$'}, 'type': {'enum': ['string', 'number', 'integer', 'boolean', 'object', 'array'], 'type': 'string'}, 'nullable': {'type': 'boolean'}, 'required': {'type': 'boolean'}}, 'additionalProperties': False}, 'maxItems': 100, 'minItems': 1}}, 'additionalProperties': False}, 'baseline': {'type': 'object', 'example': {'asset': '0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913', 'route': '/v1/weather', 'method': 'POST', 'pay_to': '0x1111111111111111111111111111111111111111', 'network': 'eip155:8453', 'observed_at': '2026-09-19T00:00:00.000Z', 'input_fields': [{'name': 'city', 'type': 'string', 'nullable': False, 'required': True}], 'price_atomic': '10000', 'output_fields': [{'name': 'temperature', 'type': 'number', 'nullable': False, 'required': True}]}, 'required': ['observed_at', 'route', 'method', 'price_atomic', 'network', 'asset', 'pay_to', 'input_fields', 'output_fields'], 'properties': {'asset': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'route': {'type': 'string', 'pattern': "^/[A-Za-z0-9._~!$&'()*+,;=:@%/-]{0,255}$", 'maxLength': 256, 'minLength': 1}, 'method': {'enum': ['GET', 'POST', 'PUT', 'PATCH', 'DELETE'], 'type': 'string'}, 'pay_to': {'type': 'string', 'pattern': '^0x[0-9a-fA-F]{40}$'}, 'network': {'type': 'string', 'maxLength': 64, 'minLength': 1}, 'observed_at': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T', 'maxLength': 40}, 'input_fields': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'type', 'required', 'nullable'], 'properties': {'name': {'type': 'string', 'pattern': '^[A-Za-z][A-Za-z0-9_]{0,63}$'}, 'type': {'enum': ['string', 'number', 'integer', 'boolean', 'object', 'array'], 'type': 'string'}, 'nullable': {'type': 'boolean'}, 'required': {'type': 'boolean'}}, 'additionalProperties': False}, 'maxItems': 100, 'minItems': 1}, 'price_atomic': {'type': 'string', 'pattern': '^[0-9]{1,18}$'}, 'output_fields': {'type': 'array', 'items': {'type': 'object', 'required': ['name', 'type', 'required', 'nullable'], 'properties': {'name': {'type': 'string', 'pattern': '^[A-Za-z][A-Za-z0-9_]{0,63}$'}, 'type': {'enum': ['string', 'number', 'integer', 'boolean', 'object', 'array'], 'type': 'string'}, 'nullable': {'type': 'boolean'}, 'required': {'type': 'boolean'}}, 'additionalProperties': False}, 'maxItems': 100, 'minItems': 1}}, 'additionalProperties': False}, 'merchant_service_id': {'type': 'string', 'example': 'merchant.weather', 'pattern': '^[A-Za-z][A-Za-z0-9_.-]{0,127}$'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['request_id', 'service_id', 'service_version', 'report_version', 'merchant_service_id', 'checked_at', 'snapshot', 'checks', 'conclusion', 'coverage', 'limitations', 'security_audit_performed'], 'properties': {'checks': {'type': 'array', 'items': {'type': 'object', 'required': ['rule_id', 'status', 'evidence'], 'properties': {'status': {'enum': ['pass', 'fail', 'not_evaluated'], 'type': 'string'}, 'rule_id': {'type': 'string'}, 'evidence': {'type': 'object'}, 'remediation': {'type': 'string'}}, 'additionalProperties': False}}, 'coverage': {'type': 'object', 'required': ['supplied_snapshots', 'rules_evaluated', 'rules_not_evaluated', 'network_fetches', 'paid_outputs_verified'], 'properties': {'network_fetches': {'type': 'integer'}, 'rules_evaluated': {'type': 'integer'}, 'supplied_snapshots': {'type': 'integer'}, 'rules_not_evaluated': {'type': 'integer'}, 'paid_outputs_verified': {'type': 'integer'}}, 'additionalProperties': False}, 'snapshot': {'type': 'object', 'required': ['baseline_observed_at', 'current_observed_at', 'baseline_sha256', 'current_sha256', 'changed'], 'properties': {'changed': {'type': 'boolean'}, 'current_sha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'baseline_sha256': {'type': 'string', 'pattern': '^[0-9a-f]{64}$'}, 'current_observed_at': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T'}, 'baseline_observed_at': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T'}}, 'additionalProperties': False}, 'checked_at': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}T', 'description': 'Server evaluation time; distinct from caller-supplied observation times.'}, 'conclusion': {'enum': ['compatible', 'incompatible', 'insufficient_evidence'], 'type': 'string'}, 'request_id': {'type': 'string', 'description': 'Delivery request identifier; also returned in x-foundry-request-id.'}, 'service_id': {'type': 'string', 'description': 'Canonical service identifier.'}, 'limitations': {'type': 'array', 'items': {'type': 'string'}}, 'report_version': {'type': 'string'}, 'service_version': {'type': 'string', 'description': 'Version of the invoked service.'}, 'merchant_service_id': {'type': 'string'}, 'security_audit_performed': {'type': 'boolean'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['source_url', 'html'], 'properties': {'html': {'type': 'string', 'example': '<script type="application/ld+json">{"@context":"https://schema.org","@type":"Product","name":"Widget","offers":{"@type":"Offer","price":"19.95","priceCurrency":"USD"}}</script>', 'maxLength': 262144}, 'source_url': {'type': 'string', 'format': 'uri', 'example': 'https://example.com/products/widget', 'maxLength': 2048}}, 'additionalProperties': False}

{'type': 'object', 'required': ['capability_id', 'version', 'source', 'product', 'evidence'], 'properties': {'source': {'type': 'object'}, 'product': {'type': 'object'}, 'version': {'type': 'string'}, 'evidence': {'type': 'object'}, 'capability_id': {'const': 'public_catalog_offer_evidence'}}, 'additionalProperties': False}