🪔 Diwali Dhamaka Sale: Festive Price Drops
🪔Diwali Festive Hot Searches
🪔 Festive Offers Active⚡ Fat Tyre E-Bikes🎁 Conversion Kits💰 Cycles Under ₹20k👩 Women's E-Cycles
API v1.0.0 • Operational

Voltebyk API & Developer Documentation

Build agentic commerce, vehicle configurators, and inventory integrations with India's leading electric bicycle brand.

Quickstart GuideInteractive SandboxModel Context Protocol (MCP)GitHub Org →

OpenAPI 3.1 Spec

Typed schema definitions, function-calling operations, and RFC 9457 error models.

/.well-known/openapi.json

MCP Server

Connect Claude Desktop, Cursor, and agent swarms with Model Context Protocol.

/mcp

LLMs.txt Reference

Structured agent instructions, when-to-use guidance, and full product knowledge base.

/llms.txt

Quickstart Integration

The Voltebyk v1 REST API is open for public queries. All responses return application/json with standard RFC RateLimit headers.

cURL Example

# Retrieve all electric cycles
curl -sS -H "Accept: application/json" \
  https://voltebyk.in/api/v1/products

# Request markdown representation
curl -sS -H "Accept: text/markdown" \
  https://voltebyk.in/

JavaScript / TypeScript

const res = await fetch('https://voltebyk.in/api/v1/products', {
  headers: { 'Accept': 'application/json' },
});
const products = await res.json();
console.log('Total electric cycles:', products.length);

Official CLI Tool

# Run directly with npx
npx voltebyk products list

# Get specific conversion kit details
npx voltebyk kits list

Interactive Sandbox

Simulate API calls with the sandbox key vb_sandbox_demo_key_2026.

REST API v1 Endpoints

GET/api/v1/products— List all electric cycles

Returns all Voltebyk electric bicycles with pricing in INR (₹), motor wattage, and range.

GET/api/v1/product/350w-electric-cycle— Get single electric cycle

Returns specifications, battery capacity, Microshift 21-Speed gears, and stock status.

GET/api/v1/kits— List conversion kits

Returns 36V 250W & 350W BLDC conversion kits with wheel compatibility (24T-29T, fat bike).

GET/api/v1/accessories— List accessories & spares

Returns 36V Li-ion battery packs, smart chargers, throttles, and genuine replacement parts.

GET/api/v1/stores— List stores & service centers

Returns verified dealer and service partner locations across India.

GET/api/v1/models— List frame configurations

Returns model specs including Geometry Alpha Hydro Alloy with 10-year frame warranty.

Rate Limits (RFC 9457 & IETF)

Public API clients receive 100 requests per 60-second sliding window. Standard IETF headers are sent on all responses:

  • RateLimit-Limit: 100
  • RateLimit-Remaining: [99-0]
  • RateLimit-Reset: 60
  • RateLimit-Policy: 100;w=60
  • Retry-After: 60 (returned on 429 status)

Versioning & Deprecation Policy

All endpoints use URL path versioning (/api/v1/) and return the API-Version: 1.0.0 header.

Breaking changes or version retirements are announced at least 180 days in advance via the Sunset and Deprecation response headers (RFC 8594).