Get started

Run in Postman

Import the entire Bolcho API into Postman in seconds and start firing live requests, every endpoint, grouped, with sample bodies and bearer auth pre-wired.

Option 1 — Import the Bolcho collection

Download the ready-made collection from the button in the sidebar, then in Postman choose Import and drop the file in. Or use Import → Link and paste the collection URL:

bash

http://localhost:3000/api/postman

Option 2 — Import the OpenAPI spec

The docs ship a complete OpenAPI 3.1 document covering every endpoint here. In Postman (or Insomnia, Hoppscotch, or any OpenAPI tool): Import → Link and paste the spec URL — it builds a collection automatically.

bash

http://localhost:3000/api/openapi

Set your variables

After importing, open the collection's Variables tab and set BOLCHO_API_KEY to your API key. baseUrl already points at the v1 URL. Bearer auth is applied to every request automatically — hit Send and you're live.

Building for LLM agents? An llms.txt index of these docs is served at /llms.txt.