Skip to main content

Build on BuyVerse.ai

The BuyVerse.ai API is REST over HTTPS with JSON responses. Use it to manage products, orders and payments, or to connect an AI agent to your business.

Base URL

Every endpoint sits behind the API gateway under /api/v1, which forwards each request to the service that owns it.

Production
https://api.buyverse.ai/api/v1
Staging
https://api.staging.buyverse.ai/api/v1

Authentication

A person signed in to BuyVerse.ai sends a user token. A machine or an AI agent sends a scoped API key with its key ID.

Business owners create and rotate keys in API keys.

Request headers
# A person signed in to BuyVerse.ai
Authorization: Bearer <jwt>

# A machine or AI agent
X-API-Key: <key>
X-API-Key-ID: <key-id>

Your first request

List the businesses your credentials can see. A list in the response means your token works.

Request: GET /businesses
curl --request GET \
  --url https://api.buyverse.ai/api/v1/businesses \
  --header 'Authorization: Bearer YOUR_TOKEN'

Explore the docs

  • API reference

    Every REST endpoint the gateway serves, read live from its OpenAPI document.

  • MCP integration

    Connect Claude and other MCP clients to BuyVerse.ai tools.

  • GPT Actions

    Give a custom GPT access to BuyVerse.ai through an Actions schema.

  • Webhooks

    Receive signed order, payment and inventory events at your own URL.

  • Integrations

    Connectors for accounting, point of sale, inventory, banking and calendars.

  • SDKs

    Client examples in TypeScript and Python.

  • Changelog

    API and platform changes, newest first.