Welcome

bizsupply API Documentation

Welcome to the bizsupply API documentation. This guide will help you integrate with the bizsupply document processing platform.


Getting Started

New to bizsupply? Start here.

GuideDescription
System OverviewPlatform capabilities and core workflows
Key ConceptsEssential concepts: plugins, ontologies, pipelines, documents

SDK

Build plugins using the bizsupply-sdk package:

pip install bizsupply-sdk
CommandDescription
bizsupply init <type> --name <name>Scaffold a new plugin, benchmark, or ontology
bizsupply validate <file>Validate plugin or ontology code
bizsupply tutorialInteractive development workflow tutorial

Developer Journeys

Step-by-step guides for common tasks.

Plugin Development

JourneyDescription
Create a PluginOverview of plugin development
Classification PluginCategorize documents with labels
Extraction PluginExtract structured data from documents
Source PluginIngest documents from external sources
BenchmarkScore documents and compare metrics

Workflows

JourneyDescription
Use PluginsExecute plugins via pipelines
Create an OntologyDefine data extraction schemas
Create a PromptCreate reusable LLM prompt templates
Process DocumentsEnd-to-end document processing workflow

Reference

Technical specifications and API documentation.

ReferenceDescription
Plugin InterfaceREQUIRED - Plugin contract and requirements
Plugin Service APIAvailable helper methods for plugins

Integrations

Connect AI assistants and external tools to bizSupply.

IntegrationDescription
MCP IntegrationConnect Claude Desktop, Cursor, or Claude Code via MCP

Templates

Use the SDK CLI to scaffold new plugins, or copy templates from the dedicated guides:

bizsupply init classification --name my_classifier
bizsupply init extraction --name my_extractor
bizsupply init source --name my_source
Plugin TypeGuide
Source PluginCreate a Source Plugin
Classification PluginCreate a Classification Plugin
Extraction PluginCreate an Extraction Plugin

Quick Navigation

I want to...

Understand the platform

Learn core concepts

Build a custom plugin

Process documents end-to-end

Define extraction schemas

Connect an AI assistant


Authentication

All API endpoints require JWT Bearer token authentication:

Authorization: Bearer <your_jwt_token>

Tokens are obtained through OAuth2 authentication with Google or Microsoft.


API Reference

For detailed API endpoint documentation, see the API Reference.


Support

Need help? Contact [email protected]