API Reference

The public routes of the Bazantic API, and the links to its full OpenAPI reference.

The Bazantic API serves the public catalog of gateways and Recipes. Its base URL is https://api.bazantic.com.

Read the full reference

https://api.bazantic.com/docs is an interactive reference for every route.
https://api.bazantic.com/openapi.json is the OpenAPI 3.1 document. Give it to a code generator or to an agent.

The API builds both from the route code, so the reference agrees with the routes that the API serves.

These routes need no API key. An anonymous call sees active gateways and published Recipes only.

Method	Path	Purpose
`GET`	`/v1/gateways`	List the active gateways. `expanded=true` adds the methods of each gateway.
`GET`	`/v1/gateways/{slug}`	Get one active gateway.
`GET`	`/v1/gateways/{slug}/methods`	List the methods of one active gateway.
`GET`	`/v1/gateways/{slug}/spec`	Get the OpenAPI or OpenRPC document of one gateway. The answer can be a redirect to the spec URL of the provider.
`GET`	`/v1/recipes`	List the published Recipes.
`GET`	`/v1/recipes/{handle}`	Get one published Recipe.
`POST`	`/mcp`	The public Recipe MCP server. It answers `initialize` and `tools/list`. It does not run a Recipe.
`GET`	`/health`	Report that the API is up.

The gateway routes answer 304 Not Modified to a request with a current If-Modified-Since header.

Method	Path	Credential
`POST`	`/control-mcp`	A CLI session from `baz login`. The Recipe tools and the gateway discovery tools use this route.

See Recipe tools in an MCP client for the control tools. The reference at /docs also lists the routes that need an API key.

To run a published Recipe, call it through its paid gateway. See Wire in the Recipe catalog.