{"openapi":"3.1.0","info":{"title":"VerisGov Data Access API","version":"1.0.0","description":"Verified federal-program intelligence. Every data response carries tier (golden = fidelity-verified, abstract = integrity-verified) and sealed provenance; /v1/verify re-derives any artifact's seal at no charge."},"servers":[{"url":"https://api.verisgov.com"}],"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}}},"paths":{"/v1/status":{"get":{"summary":"Service status + currently served snapshot version","security":[],"x-auth-level":"public","parameters":[{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/catalog/states":{"get":{"summary":"Public catalog of covered states (slug, tier, entitlement required)","security":[],"x-auth-level":"public","parameters":[{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/catalog/programs":{"get":{"summary":"Public catalog of covered federal programs","security":[],"x-auth-level":"public","parameters":[{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/rhtp/states/{slug}":{"get":{"summary":"Full sealed state corpus (envelope-wrapped)","security":[{"bearerAuth":[]}],"x-auth-level":"key","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/rhtp/states/{slug}/seal":{"get":{"summary":"State seal + capsule chain position","security":[{"bearerAuth":[]}],"x-auth-level":"key","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/rhtp/states/{slug}/{section}":{"get":{"summary":"State sub-resource: ledger | officials | nofos | documents","security":[{"bearerAuth":[]}],"x-auth-level":"key","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"section","in":"path","required":true,"schema":{"type":"string"}},{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/landscape/programs/{slug}":{"get":{"summary":"Sealed federal program rollup + deep-research merge","security":[{"bearerAuth":[]}],"x-auth-level":"key","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/landscape/recipients/{slug}":{"get":{"summary":"Sealed state-agency portfolio (per-award ledger)","security":[{"bearerAuth":[]}],"x-auth-level":"key","parameters":[{"name":"slug","in":"path","required":true,"schema":{"type":"string"}},{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/deadlines":{"get":{"summary":"Open/closing solicitations across entitled scopes","security":[{"bearerAuth":[]}],"x-auth-level":"key","parameters":[{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/rollup":{"get":{"summary":"50-state comparative dataset (watch+)","security":[{"bearerAuth":[]}],"x-auth-level":"key","parameters":[{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/freshness":{"get":{"summary":"Roster-wide data currency (watch+)","security":[{"bearerAuth":[]}],"x-auth-level":"key","parameters":[{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/search":{"get":{"summary":"Keyword search over the publish-time index, scoped to entitlements","security":[{"bearerAuth":[]}],"x-auth-level":"key","parameters":[{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/changes":{"get":{"summary":"Semantic change events vs the previous snapshot (?since= sanity check)","security":[{"bearerAuth":[]}],"x-auth-level":"key","parameters":[{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/verify/{artifact}":{"get":{"summary":"Recompute an artifact's seal against the signed manifest (keyless: verification is free)","security":[],"x-auth-level":"public","parameters":[{"name":"artifact","in":"path","required":true,"schema":{"type":"string"}},{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/verify":{"post":{"summary":"Attest a client-held copy: {artifact, sha3_256, snapshot?}","security":[],"x-auth-level":"public","parameters":[{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/account/keys":{"get":{"summary":"List this account's API keys (prefixes only)","security":[{"bearerAuth":[]}],"x-auth-level":"key","parameters":[{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}},"post":{"summary":"Create a new API key (secret shown exactly once)","security":[{"bearerAuth":[]}],"x-auth-level":"key","parameters":[{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/account/keys/{id}":{"delete":{"summary":"Revoke an API key","security":[{"bearerAuth":[]}],"x-auth-level":"key","parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string"}},{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/account/usage":{"get":{"summary":"Monthly usage summary (?month=YYYY-MM, default current)","security":[{"bearerAuth":[]}],"x-auth-level":"key","parameters":[{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/admin/grant":{"post":{"summary":"Operator: grant an entitlement (channel/enterprise customers)","security":[{"bearerAuth":[]}],"x-auth-level":"admin","parameters":[{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/admin/customers":{"post":{"summary":"Operator: create a customer + first key (channel onboarding)","security":[{"bearerAuth":[]}],"x-auth-level":"admin","parameters":[{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/billing/checkout":{"post":{"summary":"Start a subscription checkout: {kind: watch|state|program, slugs?, email}","security":[],"x-auth-level":"public","parameters":[{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}},"/v1/billing/webhook":{"post":{"summary":"Stripe webhook (signature-verified, replay-protected)","security":[],"x-auth-level":"public","parameters":[{"name":"snapshot","in":"query","required":false,"schema":{"type":"string"},"description":"pin a retained snapshot version"}],"responses":{"200":{"description":"envelope-wrapped response (data + tier + snapshot + _provenance + _meta)"},"401":{"description":"missing/invalid credential"},"403":{"description":"out of entitlement; error.hint.required names the scope to purchase"},"404":{"description":"not found"},"422":{"description":"invalid input"},"429":{"description":"rate limited; Retry-After header set"}}}}}}