{"uid":"cap_nwhIh4qnUdV_V11Af1PNh","slug":"mekler-ai-response-contract-checker-1d1730c6","name":"Mekler AI Response Contract Checker","description":"Check supplied JSON against a bounded Draft 2020-12 schema, declared timestamp freshness and optional claim evidence. Return separate pass/fail/review findings. Evidence assessment is advisory and uses supplied excerpts only; no external fact verification, source authentication or URL retrieval.","url":"https://api.mekler.ai/v1/data/responses/check-response-contract?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"schema":{"oneOf":[{"type":"boolean"},{"type":"object"}]},"response":{},"semantic":{"type":"array","items":{"type":"object","required":["pointer","evidence"],"properties":{"pointer":{"type":"string","maxLength":256},"evidence":{"type":"string","maxLength":3000,"minLength":1}},"additionalProperties":false},"maxItems":4,"minItems":1},"freshness":{"type":"object","required":["pointer","reference_time","max_age_seconds"],"properties":{"pointer":{"type":"string","maxLength":256},"reference_time":{"type":"string"},"max_age_seconds":{"type":"integer","maximum":31536000,"minimum":0}},"additionalProperties":false},"request_id":{"type":"string","pattern":"^[A-Za-z0-9_-]{16,64}$"}}},"responseSchema":{"type":"json","example":{"schema":{"draft":"2020-12","errors":[],"status":"pass","format_assertions":["date-time","ipv4","ipv6","uuid"],"error_limit_reached":false},"status":"ok","verdict":"pass","semantic":{"claims":[],"method":null,"status":"not_requested"},"freshness":{"reason":"within_declared_age","status":"pass","pointer":"/updated_at","age_seconds":60},"limitations":["Only the requested contract is checked; pass is not proof of truth, source authenticity or suitability for a consequential decision."],"observed_at":"2026-10-21T12:01:00Z"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.05","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.05/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.05","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_wJbx0EahqrUuX1ASzgsdF","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.05","costPer":"request","priority":0,"asset":"EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates a JSON response against a Draft 2020-12 schema, checks timestamp freshness, and optionally assesses claim evidence, returning separate pass/fail/review findings for each check.","exampleAgentPrompt":"Check this JSON response against my schema — use Draft 2020-12 validation — and also verify that the updated_at field is no more than 300 seconds old relative to now; here's the response: {\"updated_at\":\"2026-10-21T12:01:00Z\",\"price\":9.99,\"status\":\"active\"} and here's the schema: {\"type\":\"object\",\"required\":[\"updated_at\",\"price\",\"status\"],\"properties\":{\"updated_at\":{\"type\":\"string\",\"format\":\"date-time\"},\"price\":{\"type\":\"number\"},\"status\":{\"type\":\"string\"}}}.","exampleUseCases":[{"title":"Schema-gate before writing to database","prompt":"Before I save this API response to my database, validate it against my product schema — Draft 2020-12 — and make sure the record_date field is no more than 600 seconds old. Here's the response: {\"record_date\":\"2026-10-21T12:00:00Z\",\"sku\":\"ABC-123\",\"qty\":5} and the schema requires sku to be a non-empty string and qty to be a positive integer."},{"title":"Freshness check on a financial data feed","prompt":"I'm getting a price quote feed from a third-party API and I need to make sure the quotes are never staler than 60 seconds. Can you check this response payload against my schema and flag whether the quoted_at timestamp is within 60 seconds of right now?"},{"title":"Claim evidence audit for AI-generated summaries","prompt":"I have an AI-generated summary that makes three factual claims — can you check each claim against the evidence excerpts I've pulled from the source document and tell me which ones pass, fail, or need review? Here are the claim pointers and their supporting text excerpts."}],"resultDescription":"Returns an object with an overall verdict (pass/fail/review) and separate status blocks for schema validation (including Draft 2020-12 error list and format assertions checked), freshness (age in seconds, pointer used, and reason), and semantic claim assessment (per-claim findings). Also includes a limitations notice and an observed_at timestamp indicating when the check was run.","failureModes":["Invalid or unparseable JSON schema returns a schema error block with status 'fail'","Malformed JSON Pointer for freshness field causes a freshness error response","Timestamp value at the given pointer is missing or not a valid date-time string, causing freshness check to fail","Evidence excerpts exceed the 3000-character limit per item, causing a 422 validation error","More than 4 semantic claim items supplied, rejected with a validation error","request_id not matching the required 16-64 alphanumeric/underscore/hyphen pattern causes rejection","No external URL retrieval — claims referencing external sources cannot be fact-checked beyond supplied excerpts","Schema errors may be capped if error_limit_reached is true, meaning not all violations are enumerated"],"whenToPreferThis":"Choose this endpoint when you need a single call to simultaneously validate a JSON payload against a Draft 2020-12 schema, assess timestamp freshness, and optionally audit claim evidence from supplied excerpts — all in one structured verdict. Prefer it over generic JSON validators when you need freshness checking combined with schema validation, or when you need per-claim evidence review for AI-generated outputs. It is not a substitute for external fact-checking or source authentication, but it is well-suited for automated quality gates in agentic pipelines where structured pass/fail/review outputs are needed programmatically.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-27T12:35:57.674Z","isFirstParty":false,"canonicalSlug":"mekler-ai-response-contract-checker-1d1730c6"}