Buyamia Directory API

The Buyamia Directory API provides programmatic access to the entire Directory platform — businesses, products, categories, regions, and the RFQ/sourcing workflow. It is designed for machine-to-machine integration, primarily with the Procurement app at sourcing.buyamia.com.

Base URL

https://rjpxllsycikfabazvkdh.supabase.co/functions/v1/directory-api

Key Features

RESTful JSON API — Standard HTTP methods and JSON request/response bodies
API Key Authentication — Secure machine-to-machine access via X-API-Key header
Scoped Permissions — Fine-grained access control per API key (e.g. businesses.read, rfq.write)
Rate Limiting — Configurable per-key rate limits (default: 60 req/min)
Webhook Subscriptions — Real-time event notifications for RFQ updates, business changes, etc.
Semantic & Hybrid Search — AI-powered vector search with keyword fallback
Agent Gateway — AI agent interface for natural language queries
Full Data Access — Complete access to businesses, products, categories, regions, and RFQ data

Response Format

All API responses follow a consistent envelope format:

{
  "data": { ... },        // Response payload (object or array)
  "pagination": {          // Included for list endpoints
    "total": 150,
    "limit": 20,
    "offset": 0,
    "has_more": true
  },
  "error": null            // Error message string if request failed
}

API Versioning

All endpoints are prefixed with /v1/. Future breaking changes will use a new version prefix (e.g., /v2/). Non-breaking additions (new fields, new endpoints) may be added to the current version without notice.

Quick Start

Last updated on February 23, 2026