Buddo Platform — API Documentation

Build on the Buddo loyalty and rewards platform

Buddo is a loyalty and rewards platform built around an operator model. Businesses sign up as operators, deploy containerized apps to the platform, and tap into a shared economy of loyalty points, social features, and advertising tools. Players earn and spend across every app on the network without managing separate accounts.

Reference

Auto-generated from the OpenAPI specification. Covers all 98 endpoints across authentication, OAuth, deploy, social, operator, user, public, education, infrastructure, ad marketplace, and external campaign routes.

Browse endpoints

Quickstart

Go from zero to a working operator app in under ten minutes. Register, authenticate, deploy a container, and issue your first loyalty points.

Get started

Guides

Deep dives into OAuth PKCE flows, JWT token handling, the deploy lifecycle, social integration, and the ad marketplace.

Read guides

CLI

Manage apps, deployments, campaigns, and billing from the terminal. Includes an Agent Automation Guide for fully scripted operator workflows.

CLI Quickstart

API Base URL

https://api.buddo.xyz

OpenAPI Specification

The full machine-readable specification is available at:
https://api.buddo.xyz/.well-known/openapi.json

A local copy is also served from this site: openapi.json

Machine-Readable Formats

This documentation site provides structured files for AI agents and automated tooling:

AGENTS.md — Agent-oriented instructions for interacting with the Buddo API and CLI
llms.txt — LLM-friendly site summary following the llms.txt convention
openapi.json — Full OpenAPI 3.1 specification