{"uid":"cap_USuycksw-w4GDr2JNKMlk","slug":"data-freshness-certificate-cfc7f68e","name":"Data Freshness Certificate","description":"Calculate data age against an explicit freshness policy","url":"https://phion.systems/v1/paid/trust/data-freshness-certificate","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema"},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","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.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_OChdzH81yjD4RtC6CRh3u","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Calculate data age against an explicit freshness policy and return a certificate indicating whether the data meets freshness requirements","exampleAgentPrompt":"Check whether this dataset is still fresh enough to use — it was last updated at 2024-06-01T10:00:00Z and our policy requires data to be no older than 24 hours; give me a freshness certificate I can attach to the workflow.","exampleUseCases":[{"title":"Pre-decision data staleness check","prompt":"Before I let the pricing agent act on this market data snapshot from 2 hours ago, verify it meets our freshness policy of no more than 3 hours old and give me a signed certificate I can log."},{"title":"Cached API response validation","prompt":"I have a cached weather API response timestamped yesterday at 5pm — can you check it against our freshness rule of 6 hours max age and tell me if it's still valid to use?"},{"title":"Audit trail for compliance reporting","prompt":"Generate a freshness certificate for this customer record last modified on 2024-05-28T08:30:00Z, evaluated against our data-use policy that requires records to be no older than 7 days."}],"resultDescription":"Returns a structured certificate indicating the calculated age of the data, whether it satisfies the provided freshness policy, the degree of staleness or remaining freshness window, and an attestation receipt that can be logged or forwarded as trust evidence.","failureModes":["Missing or unparseable timestamp in input — returns validation error","No freshness policy provided — returns schema error","Timestamp in future relative to current time — may return error or zero-age result","Malformed policy thresholds — returns policy parse error","Network or service timeout — HTTP 5xx response"],"whenToPreferThis":"Choose this endpoint when you need a tamper-evident, policy-aware certificate of data freshness rather than a simple age calculation. It is ideal for agent workflows that must prove compliance with data recency SLAs, audit pipelines that require attestation receipts, or multi-agent handoffs where the receiving agent needs verifiable assurance that upstream data was fresh at the time of use. Prefer over ad-hoc timestamp comparisons when auditability or downstream verification is required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T06:52:01.729Z","isFirstParty":false}