{"uid":"cap_spw5GTdd7aN_yr9P8lMVj","slug":"hermes-data-contract-check-18e758b6","name":"Hermes Data Contract Check","description":"Agent utilities for company research, package maintenance intelligence, dependency vulnerability checks, counterparty availability, SEC company snapshots, OFAC sanctions screening, and deterministic JSON/CSV data-quality work. Company domain intelligence includes a free preview before the paid enrichment call.","url":"https://hermes-counterparty-api.onrender.com/v1/data-contract-check","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"dataset":{"oneOf":[{"type":"object","required":["format","records"],"properties":{"format":{"type":"string","const":"json"},"records":{"type":"array","items":{"type":"object"}}}},{"type":"object","required":["format","data"],"properties":{"data":{"type":"string"},"format":{"type":"string","const":"csv"}}}]},"contract":{"type":"object","properties":{"field_types":{"type":"object"},"required_fields":{"type":"array","items":{"type":"string"}},"allow_extra_fields":{"type":"boolean"}}}}},"responseSchema":{"type":"json","example":{"reasons":[],"compatible":true,"extra_fields":[],"schema_version":"1.0","type_mismatches":[],"schema_fingerprint":"sha256:example","missing_required_fields":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.015","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.015/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.015","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_M2qY5-hAaL6Y1NT4dZ41p","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.015","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates JSON or CSV datasets against a declared data contract, reporting missing fields, type mismatches, and extra fields.","exampleAgentPrompt":"Can you check whether this JSON dataset meets our data contract — the contract requires 'user_id' (string), 'timestamp' (string), and 'amount' (number) as required fields, no extra fields allowed, and here are the records: [{\"user_id\":\"abc\",\"timestamp\":\"2024-01-01\",\"amount\":9.99}]?","exampleUseCases":[{"title":"Pre-ingestion pipeline schema gate","prompt":"Before we load this CSV into the warehouse, check it against our contract: required fields are 'order_id', 'product_sku', and 'quantity', types should be string, string, and number respectively, and no extra columns are allowed. Here's the CSV data."},{"title":"Agent-generated output quality check","prompt":"My data-generating agent just produced a batch of JSON records with fields 'customer_id', 'email', and 'signup_date' — can you validate them against a contract that requires all three fields as strings and allows no extras, and tell me if there are any type mismatches or missing values?"},{"title":"Third-party data delivery verification","prompt":"We received a JSON file from a vendor claiming it matches our agreed schema: required fields are 'transaction_id' (string), 'amount' (number), and 'currency' (string), and extra fields are permitted. Can you run a data contract check and give me a compatibility report?"}],"resultDescription":"Returns a JSON object indicating whether the dataset is compatible with the contract (true/false), plus lists of missing required fields, type mismatches, extra fields, and human-readable failure reasons. Also includes a schema version string and a SHA-256 schema fingerprint for audit traceability.","failureModes":["Invalid or malformed JSON/CSV input returns an error before validation runs","Contract specifying field types that don't match any supported type descriptor may produce unexpected results","Very large record arrays may time out on the hosted Render instance","Missing 'format' field in dataset object causes request rejection","Payment not fulfilled (x402) results in a 402 response before any validation occurs"],"whenToPreferThis":"Choose this endpoint when you need a deterministic, structured report of schema conformance for JSON or CSV data against a formal contract — especially in agentic pipelines where you need machine-readable pass/fail results with field-level detail. Prefer it over ad-hoc LLM-based validation when auditability and a stable schema fingerprint matter, or when you need to catch type mismatches and missing fields reliably at low cost ($0.015 per call).","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T06:39:53.723Z","isFirstParty":false}