Seller Endpoints

Endpoints for Sellers to manage their customer relationships

GET

/customers/seller/{sellerId}

Get Customers by Seller

Get all customers for a specific seller

Response

Response (200 OK)

{
  "data": {
    "customers": [
      {
        "id": "cus_123456",
        "buyerName": "John Doe",
        "customerType": "VIP",
        "totalBookings": 5,
        "totalSpent": 500.00,
        "isFollower": true
      }
    ],
    "total": 150
  },
  "message": "Customers retrieved successfully",
  "success": true
}

GET

/customers/seller/{sellerId}/followers

Get Followers for Seller

Get all followers for a specific seller

Response

Response (200 OK)

{
  "data": {
    "followers": [
      {
        "id": "cus_123456",
        "buyerName": "John Doe",
        "followedAt": "2025-09-15T10:00:00Z",
        "totalBookings": 5
      }
    ],
    "total": 85
  },
  "message": "Followers retrieved successfully",
  "success": true
}

GET

/customers/seller/{sellerId}/favorites

Get Favorite Customers

Get favorite customers for a specific seller

Response

Response (200 OK)

{
  "data": {
    "favorites": [
      {
        "id": "cus_123456",
        "buyerName": "John Doe",
        "customerType": "VIP",
        "totalSpent": 2500.00,
        "markedFavoriteAt": "2025-08-01T10:00:00Z"
      }
    ],
    "total": 30
  },
  "message": "Favorite customers retrieved successfully",
  "success": true
}

GET

/customers/seller/{sellerId}/high-value

Get High-Value Customers

Get high-value customers for a specific seller

Query Parameters

minLifetimeValue=500

Response

Response (200 OK)

{
  "data": {
    "customers": [
      {
        "id": "cus_123456",
        "buyerName": "John Doe",
        "lifetimeValue": 2500.00,
        "totalBookings": 25,
        "customerType": "VIP"
      }
    ],
    "total": 15
  },
  "message": "High-value customers retrieved successfully",
  "success": true
}

GET

/customers/seller/{sellerId}/analytics

Get Analytics for Seller

Get customer analytics for a specific seller

Response

Response (200 OK)

{
  "data": {
    "totalCustomers": 150,
    "activeCustomers": 120,
    "followers": 85,
    "totalRevenue": 50000.00,
    "averageOrderValue": 100.00,
    "customerRetentionRate": 0.85
  },
  "message": "Analytics retrieved successfully",
  "success": true
}