PubFi’s interactive API reference is hosted by the runtime API service: The machine-readable OpenAPI schema is:

What It Covers

The API reference is the executable HTTP contract for PubFi runtime routes, including:
  • service health and readiness;
  • capability discovery and execution;
  • gateway route families;
  • API-key, account, credit, and usage routes;
  • annotated request or response details where the current OpenAPI source publishes them.

How It Fits With These Docs

Use this docs site for product concepts, agent workflows, claim boundaries, public examples, and integration guidance. Use the API reference when you need live published route families and annotated request or response details. Use the Auth Boundary section below for account and key requirements until the public OpenAPI source publishes security metadata. Use the provider gateway examples and provider docs for wildcard endpoint paths, supported methods, and nested provider payloads returned through gateway routes. Provider-specific OpenAPI snapshots are public for DeGov and Subscan examples. Generic generated gateway adapters, such as the World Bank, USGS Earthquake, National Weather Service Alerts, Crossref, ROR, DataCite, and Federal Register examples, may be public gateway_available through readiness evidence without a copied PubFi-hosted provider OpenAPI snapshot.

Auth Boundary

API reference visibility does not mean every route can be executed without an account. Live runtime calls require a PubFi API key, matching scope, credits when applicable, and current route readiness.