The Brands API provides core functionality for inventory management, merchant operations, and brand ecosystem management. All endpoints follow OpenAPI 3.0 specification.

​
Welcome to Brands API

The Brands API is the foundation of Daraa’s commerce platform, providing comprehensive inventory management, merchant operations, and brand ecosystem management. Manage SKUs, merchants, customers, orders, and subscriptions with powerful inventory tracking and fulfillment capabilities.

​
Key Features

  • Inventory Management: Real-time SKU tracking across merchants, warehouses, and locations
  • Merchant Operations: Complete merchant onboarding and management
  • Customer Management: Customer profile and relationship management
  • Order Processing: Order creation and fulfillment workflows
  • Product Management: Item catalog and product information management
  • Subscription Management: Webhook and notification subscription handling

​
Authentication

All API endpoints are authenticated using Bearer tokens.

​
Core Functionality

​
Inventory Management

  • SKU Tracking: Monitor inventory levels across multiple locations
  • Warehouse Management: Track inventory in specific warehouses
  • Location-Based Inventory: Get inventory by ZIP code and merchant
  • Shipping Integration: Calculate shipping costs and options

​
Merchant Operations

  • Merchant Onboarding: Create and manage merchant accounts
  • Store Management: Associate stores with merchants
  • Performance Tracking: Monitor merchant performance and metrics

​
Order & Customer Management

  • Order Processing: Create and manage customer orders
  • Customer Profiles: Maintain customer information and preferences
  • Product Catalog: Manage product information and availability

​
Subscription & Notifications

  • Webhook Management: Set up real-time notifications
  • Event Subscriptions: Subscribe to specific events and updates
  • Integration Support: Connect with external systems and services

​
Data Models

​
SKU Management

  • Inventory Levels: Real-time quantity tracking
  • Location Data: Warehouse and ZIP code associations
  • Cost Information: Pricing and cost calculations
  • Shipping Data: Delivery options and costs

​
Merchant Operations

  • Merchant Profiles: Complete merchant information
  • Store Associations: Merchant-store relationships
  • Performance Metrics: Tracking and analytics data

​
Order Processing

  • Order Details: Complete order information and status
  • Customer Data: Customer profiles and preferences
  • Product Information: Item details and specifications