API Documentation

Everything you need to integrate BandhanNova AI APIs into your application.

Quick Start

Get started in 3 steps:

1. Sign up at /auth/signup to get your API key.

2. Your key starts with bnova_dev_

3. Make your first request:

curl -X POST https://api4dev.bandhannova.in/api/v1/chat/completions \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"messages": [{"role": "user", "content": "Hello!"}]}'

Authentication

All API requests require an API key sent via the Authorization header:

Authorization: Bearer bnova_dev_your_api_key_here

Your API key is linked to your plan and rate limits. You can regenerate it from the dashboard.

Chat Completions

POST /api/v1/chat/completions

OpenAI-compatible chat completions endpoint. Supports streaming.

// Python
import openai

client = openai.OpenAI(
  api_key="bnova_dev_your_key",
  base_url="https://api4dev.bandhannova.in/api/v1"
)

response = client.chat.completions.create(
  model="auto",
  messages=[{"role": "user", "content": "Hello!"}]
)

Web Search

POST /api/v1/search

AI-powered web search using Tavily.

{"query": "latest AI news", "max_results": 5}

Speech to Text

POST /api/v1/stt

Audio transcription using Groq Whisper.

Market Data

GET /api/v1/market/*

Real-time financial data via TwelveData.

Error Codes

Code	Meaning
401	Invalid or missing API key
403	Account suspended
429	Rate limit exceeded — upgrade your plan
502	All upstream providers failed
503	Endpoint not configured

Rate Limits

Rate limits are per-user, per-day, based on your plan:

Plan	Requests/Day	Price
Free	100	₹0
Developer	1,000	₹99/mo
Pro	5,000	₹299/mo
Business	20,000	₹999/mo
Enterprise	Unlimited	₹2,499/mo

Rate limit headers are included in every response: X-RateLimit-Limit, X-RateLimit-Remaining, X-RateLimit-Reset.